{"_id":"@agent-invoice/mcp-server","_rev":"2-a6c592f139c954ff2a54a52202db35c0","name":"@agent-invoice/mcp-server","dist-tags":{"latest":"2.0.1"},"versions":{"2.0.0":{"name":"@agent-invoice/mcp-server","version":"2.0.0","keywords":["mcp","model-context-protocol","invoicing","agent-invoice","claude","cursor"],"license":"MIT","_id":"@agent-invoice/mcp-server@2.0.0","maintainers":[{"name":"kclemmons","email":"support@agent-invoice.com"}],"homepage":"https://agent-invoice.com/docs","bugs":{"url":"https://github.com/Agent-Invoice/invoice-pro/issues"},"bin":{"agent-invoice-mcp":"dist/index.js"},"dist":{"shasum":"9bda22c875cd1eb55e0830bd5812f32d7c054f4e","tarball":"https://registry.npmjs.org/@agent-invoice/mcp-server/-/mcp-server-2.0.0.tgz","fileCount":3,"integrity":"sha512-RP/iRFfAs9zXA/8QGEPo4DYa+YvW+Pn/UqOXHVmUOqAqzvCOYVaobEQgtq73EoPL4Px7PPGe+F/aHWV6TDpUJw==","signatures":[{"sig":"MEYCIQCcTggEveB50BQJs2snDea4EtWNZq+hr8t2xcB42P+jWwIhALBI4bQnuGq76J9t/BHGVmUSG1pYXqXS2KoKmxw6EIGA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9183},"main":"dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"16ee5429ecd7aa043f63e052b0cdf9b56f643a02","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"kclemmons","email":"support@agent-invoice.com"},"repository":{"url":"git+https://github.com/Agent-Invoice/invoice-pro.git","type":"git","directory":"mcp"},"_npmVersion":"10.9.8","description":"Model Context Protocol (MCP) server for Agent Invoice: create clients, issue invoices and estimates, record payments and send them from Claude, Cursor and any MCP client.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.2","@types/node":"^22.5.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.0.0_1789084219100_0.8588054655669823","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"_id":"@agent-invoice/mcp-server@2.0.1","bin":{"agent-invoice-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/Agent-Invoice/invoice-pro/issues"},"dist":{"shasum":"2d89e5af7a6d9678ef742623b634a936ac610093","tarball":"https://registry.npmjs.org/@agent-invoice/mcp-server/-/mcp-server-2.0.1.tgz","fileCount":3,"integrity":"sha512-p01s3UU6RfSPIt8af5EI/DLkpmP0Eg/msbvTtjjVKadQ3k9Fu4DkF9OFWgQWrN6UBaEoIig4kqVMxbnRKVk9SA==","signatures":[{"sig":"MEUCIQCR3BhvHqOFIchYa1fN/ydZ72xJPv4vp+sErLJn7lWi0AIgJcwItv2CSMw3dVquFn3rTG6Tg59b24GkXXV/XVOITSI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCkt+VgGd3mp3t8SB7mId1pTHtT3cCyc5xfT8RTcXbxcQIhAKAF1Q3t6gYQ+FX5BhMVuVg/AwcdkaYklXEVfShCkyaq"}],"unpackedSize":11017},"main":"dist/index.js","name":"@agent-invoice/mcp-server","type":"module","engines":{"node":">=20"},"gitHead":"eb08785fd7a8acf1bfbb7d5ecc3543b74459b448","license":"MIT","scripts":{"dev":"tsc --watch","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","prepublishOnly":"npm run build"},"version":"2.0.1","_npmUser":{"name":"kclemmons","email":"support@agent-invoice.com"},"homepage":"https://agent-invoice.com/docs","keywords":["mcp","model-context-protocol","invoicing","agent-invoice","claude","cursor"],"repository":{"url":"git+https://github.com/Agent-Invoice/invoice-pro.git","type":"git","directory":"mcp"},"_npmVersion":"10.9.8","description":"Model Context Protocol (MCP) server for Agent Invoice: create clients, issue invoices and estimates, record payments and send them from Claude, Cursor and any MCP client.","directories":{},"maintainers":[{"name":"kclemmons","email":"support@agent-invoice.com"}],"_nodeVersion":"22.23.2","dependencies":{"@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.2","@types/node":"^22.5.5"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_2.0.1_1789110730747_0.3842112481432356"}}},"time":{"created":"2026-09-10T23:50:18.984Z","modified":"2026-09-11T07:12:11.035Z","2.0.0":"2026-09-10T23:50:19.253Z","2.0.1":"2026-09-11T07:12:10.832Z"},"bugs":{"url":"https://github.com/Agent-Invoice/invoice-pro/issues"},"license":"MIT","homepage":"https://agent-invoice.com/docs","keywords":["mcp","model-context-protocol","invoicing","agent-invoice","claude","cursor"],"repository":{"url":"git+https://github.com/Agent-Invoice/invoice-pro.git","type":"git","directory":"mcp"},"description":"Model Context Protocol (MCP) server for Agent Invoice: create clients, issue invoices and estimates, record payments and send them from Claude, Cursor and any MCP client.","maintainers":[{"name":"kclemmons","email":"support@agent-invoice.com"}],"readme":"# Agent Invoice MCP server\n\nLets Claude, Cursor, and any Model Context Protocol (MCP) client work inside\nyour Agent Invoice account: find clients, create and send invoices and\nestimates, record payments, log time, and read billing stats.\n\nThere are two ways to connect. Both need an API key from\n**Settings → Developer API** in Agent Invoice (Agency Pro plan).\n\n## 1. Remote server (recommended)\n\nThe MCP server runs inside Agent Invoice at:\n\n```\nhttps://app.agent-invoice.com/api/mcp\n```\n\nConnect any client that supports remote (Streamable HTTP) MCP servers by\ngiving it that URL and your key as a bearer token.\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http agent-invoice https://app.agent-invoice.com/api/mcp \\\n  --header \"Authorization: Bearer ie_live_your_key\"\n```\n\n**Claude.ai / Claude Desktop (custom connector)**: add a connector with the\nURL above and paste `Bearer ie_live_your_key` as the Authorization header.\n\n**Cursor** (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-invoice\": {\n      \"url\": \"https://app.agent-invoice.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer ie_live_your_key\" }\n    }\n  }\n}\n```\n\nNothing to install, nothing to update: the tool list is served live.\n\n## 2. This package (stdio)\n\nFor clients that only launch local stdio servers. It is a small bridge that\nforwards every tool call to the remote server above.\n\nRequires Node.js 20 or newer.\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-invoice\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent-invoice/mcp-server\"],\n      \"env\": { \"AGENT_INVOICE_API_KEY\": \"ie_live_your_key\" }\n    }\n  }\n}\n```\n\n**Claude Code**\n\n```bash\nclaude mcp add agent-invoice -e AGENT_INVOICE_API_KEY=ie_live_your_key -- npx -y @agent-invoice/mcp-server\n```\n\n**Cursor**: add a command server with command `npx`, args\n`-y @agent-invoice/mcp-server`, and the `AGENT_INVOICE_API_KEY` environment\nvariable.\n\nEnvironment variables:\n\n| Variable | Required | Default |\n| --- | --- | --- |\n| `AGENT_INVOICE_API_KEY` | yes | |\n| `AGENT_INVOICE_API_URL` | no | `https://app.agent-invoice.com` |\n\nThe server exits with a clear message if the key is missing or rejected, so a\nmisconfiguration shows up when the client starts rather than on the first\ntool call.\n\n## Tools\n\nRead tools are marked read-only, destructive ones are marked destructive, so\nclients that ask before running a tool ask for the right ones.\n\n| Area | Tools |\n| --- | --- |\n| Account | `get_billing_stats`, `get_business_profile`, `update_business_profile`, `get_next_invoice_number`, `search` |\n| Clients | `find_client`, `list_clients`, `get_client`, `create_client`, `update_client`, `delete_client` |\n| Invoices | `list_invoices`, `get_invoice`, `get_invoice_pdf`, `create_invoice`, `update_invoice`, `set_invoice_line_items`, `delete_invoice`, `send_invoice_email`, `generate_stripe_link`, `mark_invoice_paid`, `record_payment`, `list_payments`, `send_due_reminders` |\n| Estimates | `list_estimates`, `get_estimate`, `create_estimate`, `send_estimate_email`, `convert_estimate_to_invoice` |\n| Products | `list_products`, `create_product` |\n| Time | `list_time_entries`, `log_time`, `invoice_from_time_entries` |\n| Recurring | `list_recurring_invoices`, `create_recurring_invoice` |\n\nEvery tool runs through the same REST API as your own code would, with the\nsame key, so a key's scopes (`read`, `write`, `send`) apply to tools too: a\nread-only key can list and fetch but cannot create or send.\n\n## Development\n\nThe tool catalogue lives in the API (`backend/src/mcp/tools.ts`), not in\nthis package. To work on it, run the backend and point this bridge at it:\n\n```bash\nnpm install            # from the repository root; mcp is a workspace\nnpm run build --workspace=mcp\nAGENT_INVOICE_API_URL=http://localhost:3001 AGENT_INVOICE_API_KEY=ie_live_... node mcp/dist/index.js\n```\n\nReleases are published to npm by the `Publish MCP package` workflow when a\ntag matching `mcp-v<version>` is pushed; the version must match\n`package.json`.\n","readmeFilename":"README.md"}