rosetta-mcp

rosetta-mcp

MCP server for Rosetta — parse, extract, split, and ask over digital PDFs (embedded text layer, no OCR) from Cursor, Claude Desktop, and other MCP clients.

Install from npm: npx -y rosetta-mcp (current 0.2.2).

MCP Registry name: io.github.Jcjimenezglez/rosetta-mcp.

Install

Add to .cursor/mcp.json (Cursor) or Claude Desktop config:

{
  "mcpServers": {
    "rosetta": {
      "command": "npx",
      "args": ["-y", "rosetta-mcp"],
      "env": {
        "ROSETTA_API_KEY": "your-api-key",
        "ROSETTA_API_URL": "https://rosettafolio.com"
      }
    }
  }
}

Get an API key at rosettafolio.com/dashboard. The key is shown once on create/rotate.

Environment variables

Variable	Required	Default	Description
ROSETTA_API_KEY	Yes	—	API key from Rosetta dashboard
ROSETTA_API_URL	No	https://rosettafolio.com	Rosetta API base URL

Legacy fallbacks (still supported): DOCCHAT_API_KEY, DOCCHAT_API_URL.

The process exits on startup if no API key is set.

Tools

Tool	REST endpoint	Description
pdf_parse	POST /api/v2/parse	Parse PDF to markdown/JSON (path, url, or docId)
pdf_extract	POST /api/v2/extract	Extract structured data (path/url/docId + schema)
pdf_split	POST /api/v2/split	Detect document sections
pdf_ask	POST /api/v2/ask	Q&A across parsed documents
pdf_credit_usage	GET /api/v2/credit-usage	Remaining credits
pdf_delete	POST /api/v2/delete	Delete a document you own

path reads a local PDF from the machine running this stdio server. Remote HTTP MCP (/api/mcp) uses url or docId only.

Auth uses header X-API-Key.

Publish

rosetta-mcp is on npm. New versions ship from GitHub Actions (.github/workflows/publish-rosetta-mcp.yml).

• Bump version in package.json and the McpServer version in src/index.ts.
• Merge to main.
• Either:
  • Add a granular npm Automation token as the repo secret NPM_TOKEN (or rosetta-publish-bypass), or
  • On the package settings at npmjs.com, add a GitHub Actions trusted publisher: user Jcjimenezglez, repo docchat, workflow publish-rosetta-mcp.yml.
• Run Actions → Publish rosetta-mcp → Run workflow.

Or from this directory after npm login:

npm publish

The tarball includes dist/, this README, and LICENSE.

Docs

• MCP setup guide
• REST API docs

License

MIT