@aranswill/mcp-server

@aranswill/mcp-server

This package implements a Model Context Protocol (MCP) stdio server for the PDF Generation API. AI clients (Claude Desktop, Cursor, and others) can discover and invoke your API as structured tools instead of ad-hoc HTTP snippets.

Base URL: https://pdfapi-nu.vercel.app

API key: Create one at https://pdfapi-nu.vercel.app/dashboard/login.

Installation

From the mcp-server directory after cloning the repo:

npm install
npm run build

To install the built CLI globally from this folder:

npm install -g .

After publishing to npm (optional):

npm install -g @aranswill/mcp-server

Or run once with npx (when the package is published):

npx @aranswill/mcp-server

For local development without publishing, point your MCP config at node and the absolute path to mcp-server/dist/index.js (see below).

Claude Desktop configuration

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %AppData%\Claude\claude_desktop_config.json

Add an entry under mcpServers (use your absolute paths):

{
  "mcpServers": {
    "pdfapi": {
      "command": "node",
      "args": ["C:/path/to/pdf-generation-api/mcp-server/dist/index.js"]
    }
  }
}

Restart Claude Desktop after saving.

Cursor configuration

In 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).

Example using the local built server:

{
  "mcpServers": {
    "pdfapi": {
      "command": "node",
      "args": ["C:/path/to/pdf-generation-api/mcp-server/dist/index.js"]
    }
  }
}

Use forward slashes or escaped backslashes in paths on Windows. Restart Cursor or reload the MCP panel after changes.

Available tools

Tool	Description
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.
list_templates	List templates and descriptions (GET /api/v1/templates). No API key required.
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.

Tool inputs (summary)

• generate_pdf: { template, data, apiKey }
• list_templates: {} (no required fields)
• get_usage: { apiKey }

Scripts

• npm run build — compile src/ to dist/
• npm start — run node dist/index.js (stdio MCP server; normally the IDE starts this process for you)

License

MIT