{"_id":"@aranswill/mcp-server","_rev":"3-6c0befb6a79d4b723c5aeec43d15da73","name":"@aranswill/mcp-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@aranswill/mcp-server","version":"1.0.0","license":"MIT","_id":"@aranswill/mcp-server@1.0.0","maintainers":[{"name":"aranswill","email":"amranswill@gmail.com"}],"bin":{"pdfapi-mcp":"dist/index.js"},"dist":{"shasum":"4b518fa06a13b812c56439007b452d4b3b1b11dc","tarball":"https://registry.npmjs.org/@aranswill/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":6,"integrity":"sha512-SruAqDrR+xtjcI0QcxcSILbVg2aYLi3gr9hW2pp8s93QTLVlqfSw/47MWFhXoEZ1m6oG57N+k17aegFu8JgqfQ==","signatures":[{"sig":"MEUCIAZ8TWgVx0wIEoYubGIZLYhxbrqN1EaGwbeiaGuz79mKAiEA0HhMu5PrXVJuKa6F+Meqcxzm6VKuoG6wZe5iG2LkIZQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18929},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b5f0bfe9fec0f89c7fc2b7afdace7431b909e83f","scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"aranswill","email":"amranswill@gmail.com"},"_npmVersion":"11.13.0","description":"MCP server that exposes the PDF Generation API (generate PDFs, list templates, check usage) to AI agents.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1783646293996_0.09347935078482572","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aranswill/mcp-server","version":"1.0.1","license":"MIT","_id":"@aranswill/mcp-server@1.0.1","maintainers":[{"name":"aranswill","email":"amranswill@gmail.com"}],"bin":{"pdfapi-mcp":"dist/index.js"},"dist":{"shasum":"1fc0f7b9c6d88416f7add0d2c974c5befff9e471","tarball":"https://registry.npmjs.org/@aranswill/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":6,"integrity":"sha512-QkkOv2AXmcq624zFVZWcAMnrqvrcYSVPgE8/tVEec9o7hb/U9OLVTTGKPqIv40tJimrl68FYtQQc78p6HhA3DQ==","signatures":[{"sig":"MEQCICzo3Dg6mu9vaQRwZOCWL3oCtx8jbDmMqWAmh2mYmQkpAiBaRvAGTCSTHRpAOPzg1eEeSTKBs2vylpSwXv10rAoqZg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18927},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b5f0bfe9fec0f89c7fc2b7afdace7431b909e83f","scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"aranswill","email":"amranswill@gmail.com"},"_npmVersion":"11.13.0","description":"MCP server that exposes the PDF Generation API (generate PDFs, list templates, check usage) to AI agents.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1783646621914_0.23612292265317403","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aranswill/mcp-server","version":"1.0.2","description":"MCP server that exposes the PDF Generation API (generate PDFs, list templates, check usage) to AI agents.","license":"MIT","type":"module","mcpName":"io.github.amranswill/pdfapi-mcp-server","bin":{"pdfapi-mcp":"dist/index.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.6.0"},"engines":{"node":">=18"},"gitHead":"b5f0bfe9fec0f89c7fc2b7afdace7431b909e83f","_id":"@aranswill/mcp-server@1.0.2","_nodeVersion":"24.17.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-yPsV8lbHSuIVrxQov4swQsLlb8SZFc/t2A4Uce/J9lnZPeIiW4lRbft/UkWkdb2P2k5oVzNv60E0EAgkwcejwg==","shasum":"5f58050fdd33479f88719b856f46838eb53471fc","tarball":"https://registry.npmjs.org/@aranswill/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":6,"unpackedSize":18983,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHiiKOG2a/TwiUDwBVKkwEYbATn7Y59xoFBQ2mTyqo5OAiEA96AzpJwILCV7UaKLUEMdSCCaI8m7OUeebsP5U8C3OYI="}]},"_npmUser":{"name":"aranswill","email":"amranswill@gmail.com"},"directories":{},"maintainers":[{"name":"aranswill","email":"amranswill@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.2_1783646734580_0.6622369469536438"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-10T01:18:13.870Z","modified":"2026-07-10T01:25:34.815Z","1.0.0":"2026-07-10T01:18:14.127Z","1.0.1":"2026-07-10T01:23:42.076Z","1.0.2":"2026-07-10T01:25:34.712Z"},"license":"MIT","description":"MCP server that exposes the PDF Generation API (generate PDFs, list templates, check usage) to AI agents.","maintainers":[{"name":"aranswill","email":"amranswill@gmail.com"}],"readme":"# @aranswill/mcp-server\r\n\r\nThis package implements a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) **stdio server** for the [PDF Generation API](https://pdfapi-nu.vercel.app). AI clients (Claude Desktop, Cursor, and others) can **discover** and **invoke** your API as structured tools instead of ad-hoc HTTP snippets.\r\n\r\n**Base URL:** `https://pdfapi-nu.vercel.app`\r\n\r\n**API key:** Create one at [https://pdfapi-nu.vercel.app/dashboard/login](https://pdfapi-nu.vercel.app/dashboard/login).\r\n\r\n## Installation\r\n\r\nFrom the `mcp-server` directory after cloning the repo:\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\n```\r\n\r\nTo install the built CLI globally from this folder:\r\n\r\n```bash\r\nnpm install -g .\r\n```\r\n\r\nAfter publishing to npm (optional):\r\n\r\n```bash\r\nnpm install -g @aranswill/mcp-server\r\n```\r\n\r\nOr run once with `npx` (when the package is published):\r\n\r\n```bash\r\nnpx @aranswill/mcp-server\r\n```\r\n\r\nFor local development without publishing, point your MCP config at `node` and the absolute path to `mcp-server/dist/index.js` (see below).\r\n\r\n## Claude Desktop configuration\r\n\r\nEdit your Claude Desktop config file:\r\n\r\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n- **Windows:** `%AppData%\\Claude\\claude_desktop_config.json`\r\n\r\nAdd an entry under `mcpServers` (use **your** absolute paths):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"pdfapi\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"C:/path/to/pdf-generation-api/mcp-server/dist/index.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nRestart Claude Desktop after saving.\r\n\r\n## Cursor configuration\r\n\r\nIn **Cursor Settings → MCP**, add a server, or edit your user MCP config (e.g. **Cursor Settings → Open MCP config** / project `.cursor/mcp.json` depending on your Cursor version).\r\n\r\nExample using the local built server:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"pdfapi\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"C:/path/to/pdf-generation-api/mcp-server/dist/index.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nUse forward slashes or escaped backslashes in paths on Windows. Restart Cursor or reload the MCP panel after changes.\r\n\r\n## Available tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| **generate_pdf** | Generate a styled PDF from JSON (`invoice`, `receipt`, or `report`). Sends `POST /api/v1/generate` with `X-API-Key`. On success, returns a JSON payload including `pdfBase64` and metadata. |\r\n| **list_templates** | List templates and descriptions (`GET /api/v1/templates`). No API key required. |\r\n| **get_usage** | Returns usage and plan limits (`GET /api/v1/usage`) using `X-API-Key`. Fields include monthly usage, remaining calls, plan tier, and RPM limit. |\r\n\r\n### Tool inputs (summary)\r\n\r\n- **generate_pdf:** `{ template, data, apiKey }`\r\n- **list_templates:** `{}` (no required fields)\r\n- **get_usage:** `{ apiKey }`\r\n\r\n## Scripts\r\n\r\n- `npm run build` — compile `src/` to `dist/`\r\n- `npm start` — run `node dist/index.js` (stdio MCP server; normally the IDE starts this process for you)\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}