{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_mra5wkww72wq","handle":"acumulus-mcp","url":"https://wellknown.network/agents/acumulus-mcp","links":{"self":"https://wellknown.network/agents/acumulus-mcp/record.json","html":"https://wellknown.network/agents/acumulus-mcp","markdown":"https://wellknown.network/agents/acumulus-mcp/record.md","api":"https://wellknown.network/api/v1/agents/acumulus-mcp","status":"https://wellknown.network/api/v1/agents/acumulus-mcp/status","claim":"https://wellknown.network/agents/acumulus-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/acumulus-mcp/claim.json","badge":"https://wellknown.network/agents/acumulus-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/acumulus-mcp/history","tools":"https://wellknown.network/api/v1/agents/acumulus-mcp/tools"},"ard":{"identifier":"urn:air::server:acumulus-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"acumulus-mcp","summary":"MCP server for Acumulus — let Claude (Desktop, Code, Cursor) read and modify your Acumulus administration via natural language.","description":"# acumulus-mcp\n\nMCP server for [Acumulus](https://www.acumulus.nl/) — let an AI assistant\n(Claude Desktop, Claude Code, Cursor, …) read and modify your Acumulus\nadministration through natural language, over the official Acumulus API.\n\nRuns locally over stdio. Your Acumulus credentials stay on your machine;\nthere is no telemetry and no proxy.\n\n## Install\n\n```bash\npip install acumulus-mcp\n```\n\nRequires Python 3.10+.\n\n## Configure credentials\n\nThe server authenticates with your Acumulus **contract code**, **username**\nand an **API token** (generate one in Acumulus under your profile; it travels\nin the API's `<password>` field). Provide them as environment variables:\n\n```bash\nexport ACUMULUS_CONTRACT_CODE=123456\nexport ACUMULUS_USERNAME=your-username\nexport ACUMULUS_API_TOKEN=your-api-token\n# optional: validate writes without persisting them\nexport ACUMULUS_TESTMODE=1\n```\n\n## Register in your MCP client\n\n**Claude Code:**\n\n```bash\nclaude mcp add acumulus \\\n  -e ACUMULUS_CONTRACT_CODE=123456 \\\n  -e ACUMULUS_USERNAME=your-username \\\n  -e ACUMULUS_API_TOKEN=your-api-token \\\n  -- acumulus-mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"acumulus\": {\n      \"command\": \"acumulus-mcp\",\n      \"env\": {\n        \"ACUMULUS_CONTRACT_CODE\": \"123456\",\n        \"ACUMULUS_USERNAME\": \"your-username\",\n        \"ACUMULUS_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\nRestart your client, then try: *\"Use the acumulus `whoami` tool to test the connection.\"*\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `whoami` | Sanity-check the connection (lists the account picklist). |\n| `list_picklist(picklist)` | Fetch reference data: `accounts`, `contacts`, `products`, `vattypes`, `costcenters`, `costheadings`, `companytypes`. |\n| `create_invoice(customer, lines, invoice=None)` | Add an invoice (`invoices/invoice_add.php`). |\n| `acumulus_request(api_path, fields=None)` | Escape hatch — call any Acumulus endpoint directly (e.g. `invoices/in…","publisher":null,"homepage":"https://easeo.nl/diensten/mcp-boekhoudpakketten","repository":"https://github.com/NickAldewereld/acumulus-mcp/issues","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["acumulus","ai","anthropic","automation","boekhouding","claude","factuur","invoicing","mcp","model-context-protocol","netherlands"],"pricing":null,"endpoints":[{"url":"pypi:acumulus-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":0.814,"provenance":"derived"}],"categories":["documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"acumulus-mcp","registry":"pypi","observedAt":"2026-10-30T19:26:43.335Z","publishedAt":"2026-10-17T10:36:00.713364Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"acumulus-mcp","url":"https://pypi.org/project/acumulus-mcp/","firstSeenAt":"2026-10-18T16:28:04.918Z","fetchedAt":"2026-10-30T19:24:30.400Z","normalizedAt":"2026-10-30T19:24:30.400Z"}]},"firstSeenAt":"2026-10-18T16:28:04.918Z","updatedAt":"2026-10-30T19:26:43.335Z"}