rosetta-mcp
v0.2.2
Published
MCP server for Rosetta — parse, extract, split, and ask over digital PDFs from Cursor IDE
Maintainers
Readme
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
versioninpackage.jsonand theMcpServerversion insrc/index.ts. - Merge to
main. - Either:
- Add a granular npm Automation token as the repo secret
NPM_TOKEN(orrosetta-publish-bypass), or - On the package settings at npmjs.com, add a GitHub Actions trusted publisher: user
Jcjimenezglez, repodocchat, workflowpublish-rosetta-mcp.yml.
- Add a granular npm Automation token as the repo secret
- Run Actions → Publish rosetta-mcp → Run workflow.
Or from this directory after npm login:
npm publishThe tarball includes dist/, this README, and LICENSE.
Docs
License
MIT
