API & MCP
Everything a person can do on PastePort — Formatting converter, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://paperwellpasteport.usefulweb.app/api/v1/calculate– run PastePort — Formatting converterGET https://paperwellpasteport.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
PastePort — Formatting converter
Convert a bounded set of nested text formatting, fenced code and links with a visual preview and explicit reports of unsupported formatting.
| Field | Type | Default | Description |
|---|---|---|---|
text | textarea | "**Hello** _world_\n\nA [useful link](https://usefulweb.site)." | Text |
from | select (markdown, slack, whatsapp, plain) | "markdown" | From |
to | select (slack, markdown, whatsapp, plain) | "slack" | To |
Example request
Try an example
curl -X POST https://paperwellpasteport.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{}'
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://paperwellpasteport.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
paperwell_pasteport - Local stdio connector:
node src/mcp-stdio.ts --tool=paperwell-pasteport
{
"mcpServers": {
"paperwell-pasteport": { "type": "http", "url": "https://paperwellpasteport.usefulweb.app/mcp" }
}
}