{"_id":"@elyonar/einvoice-mcp","_rev":"4-47a366b4bd0bd4917dfc760bca440b6b","name":"@elyonar/einvoice-mcp","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.1":{"name":"@elyonar/einvoice-mcp","version":"0.1.1","keywords":["mcp","einvoice","firs","nigeria","invoice","model-context-protocol"],"author":{"name":"Elyonar"},"license":"MIT","_id":"@elyonar/einvoice-mcp@0.1.1","maintainers":[{"name":"elyonartech","email":"tech@elyonar.ng"}],"bin":{"einvoice-mcp":"bin/cli.js"},"dist":{"shasum":"e504a915d9ec4c350166edbd9d2e275ac76ed3a4","tarball":"https://registry.npmjs.org/@elyonar/einvoice-mcp/-/einvoice-mcp-0.1.1.tgz","fileCount":64,"integrity":"sha512-/yvbaO8BSF3jnlP1eh4MhrPnRo3I7nm7rR8AB48NwHHGLfryBbF/WRjD096NlyAjd3OKl9YpL1ON1luKVrjRSA==","signatures":[{"sig":"MEUCIGt9hEKeiO6GtaORQN8XfAGt9F+gavAN1zwkwDnWnwdVAiEA7m576SEcyHYUpi0rh69/47upB9BJZcmTVkTbITFou20=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157033},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"5859b7f3b357d19a29e02b90b2556680922b43ca","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"jest --coverage","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepare":"husky","release":"standard-version","test:watch":"jest --watch","release:first":"standard-version --first-release","release:major":"standard-version --release-as major","release:minor":"standard-version --release-as minor","release:patch":"standard-version --release-as patch","prepublishOnly":"npm run build"},"_npmUser":{"name":"elyonartech","email":"tech@elyonar.ng"},"_npmVersion":"11.6.0","description":"MCP server for the E-Invoice platform — invoices, sellers, buyers, and billing","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","jest":"^29.7.0","husky":"^9.1.7","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.15.3","@commitlint/cli":"^20.5.0","standard-version":"^9.5.0","@commitlint/config-conventional":"^20.5.0"},"_npmOperationalInternal":{"tmp":"tmp/einvoice-mcp_0.1.1_1773945403576_0.04618701062028885","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@elyonar/einvoice-mcp","version":"0.1.2","keywords":["mcp","einvoice","firs","nigeria","invoice","model-context-protocol"],"author":{"name":"Elyonar"},"license":"MIT","_id":"@elyonar/einvoice-mcp@0.1.2","maintainers":[{"name":"elyonartech","email":"tech@elyonar.ng"}],"bin":{"einvoice-mcp":"bin/cli.js"},"dist":{"shasum":"b4f488c63ce412d03463a33f1dc189d9565d85a5","tarball":"https://registry.npmjs.org/@elyonar/einvoice-mcp/-/einvoice-mcp-0.1.2.tgz","fileCount":64,"integrity":"sha512-4mru//2qYrYy96ui/EbL8hHv85cK+ghjdp8/27UvFuFz/Qn9ifOca/7q6hLu3gPTZGNC04O34l+RyFI+PSoNRw==","signatures":[{"sig":"MEYCIQC95QNO7hr6UmzsqK71DTFv8Smu0/WHZeMTWVYgghhwAgIhALNbFisBVKzF9xbHG/lNbz6w5qujmEZZgIluQDBur3Nb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157035},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"925fb1a29faed48ce513f335b63c028e15a0f337","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"jest --coverage","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepare":"husky","release":"standard-version","test:watch":"jest --watch","release:first":"standard-version --first-release","release:major":"standard-version --release-as major","release:minor":"standard-version --release-as minor","release:patch":"standard-version --release-as patch","prepublishOnly":"npm run build"},"_npmUser":{"name":"elyonartech","email":"tech@elyonar.ng"},"_npmVersion":"11.6.0","description":"MCP server for the E-Invoice platform — invoices, sellers, buyers, and billing","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","jest":"^29.7.0","husky":"^9.1.7","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.15.3","@commitlint/cli":"^20.5.0","standard-version":"^9.5.0","@commitlint/config-conventional":"^20.5.0"},"_npmOperationalInternal":{"tmp":"tmp/einvoice-mcp_0.1.2_1773946243957_0.8798215193610766","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@elyonar/einvoice-mcp","version":"0.1.3","keywords":["mcp","einvoice","firs","nigeria","invoice","model-context-protocol"],"author":{"name":"Elyonar"},"license":"MIT","_id":"@elyonar/einvoice-mcp@0.1.3","maintainers":[{"name":"elyonartech","email":"tech@elyonar.ng"}],"bin":{"einvoice-mcp":"bin/cli.js"},"dist":{"shasum":"a3b90f866223d3a9f48f084722b77fb93a88b9ce","tarball":"https://registry.npmjs.org/@elyonar/einvoice-mcp/-/einvoice-mcp-0.1.3.tgz","fileCount":64,"integrity":"sha512-O3vK/sUtpzLMwu6Gnkj9TboIGeGdpL5AwvNC51LGlLqQCy4JKrvB6nsjdLKlj+VxvUMQhR0uiM1V3/xWd/fcdw==","signatures":[{"sig":"MEQCICigf4xESEqeGYulTS9YsLqSH9ZZXcBqxt2EMG+DSk8yAiACFtqMOjKFOGuII5zCeA9229RRGE1Afjiy5gQb5G4D2g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157035},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"3fda3424bd7320da8ae1f98f570add01bd7fc6d7","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"jest --coverage","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepare":"husky","release":"standard-version","test:watch":"jest --watch","release:first":"standard-version --first-release","release:major":"standard-version --release-as major","release:minor":"standard-version --release-as minor","release:patch":"standard-version --release-as patch","prepublishOnly":"npm run build"},"_npmUser":{"name":"elyonartech","email":"tech@elyonar.ng"},"_npmVersion":"10.8.2","description":"MCP server for the E-Invoice platform — invoices, sellers, buyers, and billing","directories":{},"_nodeVersion":"20.20.1","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","jest":"^29.7.0","husky":"^9.1.7","ts-jest":"^29.3.2","typescript":"^5.8.3","@types/jest":"^29.5.14","@types/node":"^22.15.3","@commitlint/cli":"^20.5.0","standard-version":"^9.5.0","@commitlint/config-conventional":"^20.5.0"},"_npmOperationalInternal":{"tmp":"tmp/einvoice-mcp_0.1.3_1773946344248_0.5157154334412093","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@elyonar/einvoice-mcp","version":"0.1.4","description":"MCP server for the E-Invoice platform — invoices, sellers, buyers, and billing","main":"dist/index.js","types":"dist/index.d.ts","bin":{"einvoice-mcp":"bin/cli.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","test":"jest --coverage","test:watch":"jest --watch","lint":"tsc --noEmit","clean":"rm -rf dist","prepare":"husky","release":"standard-version","release:minor":"standard-version --release-as minor","release:major":"standard-version --release-as major","release:patch":"standard-version --release-as patch","release:first":"standard-version --first-release","prepublishOnly":"npm run build"},"keywords":["mcp","einvoice","firs","nigeria","invoice","model-context-protocol"],"author":{"name":"Elyonar"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"@commitlint/cli":"^20.5.0","@commitlint/config-conventional":"^20.5.0","@types/jest":"^29.5.14","@types/node":"^22.15.3","husky":"^9.1.7","jest":"^29.7.0","standard-version":"^9.5.0","ts-jest":"^29.3.2","tsx":"^4.19.4","typescript":"^5.8.3"},"engines":{"node":">=18.0.0"},"_id":"@elyonar/einvoice-mcp@0.1.4","gitHead":"829e8502abb5e9107b4189e1cbf1cc69f3ebaa99","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-g9GN1NFHC76Vhm8NVB5JP6v4XF9HX6wA800jNXqQbjYw733OVzB6Si3y2feEzOdVONr3FgvmUTSD+7OLrmA6lw==","shasum":"a392225001529b570aad9f7daaf51dccb263f8bd","tarball":"https://registry.npmjs.org/@elyonar/einvoice-mcp/-/einvoice-mcp-0.1.4.tgz","fileCount":64,"unpackedSize":161241,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD3c6BtLef/5nNYgrD/29tLJvzbg749YMcRUoAabwxW1QIgBzMN7vjcRM5pdPKIQpVs/gUVWb9IaBlmFS2QVpsy9bs="}]},"_npmUser":{"name":"elyonartech","email":"tech@elyonar.ng"},"directories":{},"maintainers":[{"name":"elyonartech","email":"tech@elyonar.ng"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/einvoice-mcp_0.1.4_1773957066021_0.6485678440742846"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T18:36:43.447Z","modified":"2026-03-19T21:51:06.267Z","0.1.1":"2026-03-19T18:36:43.811Z","0.1.2":"2026-03-19T18:50:44.091Z","0.1.3":"2026-03-19T18:52:24.390Z","0.1.4":"2026-03-19T21:51:06.155Z"},"author":{"name":"Elyonar"},"license":"MIT","keywords":["mcp","einvoice","firs","nigeria","invoice","model-context-protocol"],"description":"MCP server for the E-Invoice platform — invoices, sellers, buyers, and billing","maintainers":[{"name":"elyonartech","email":"tech@elyonar.ng"}],"readme":"# @elyonar/einvoice-mcp\n\nMCP (Model Context Protocol) server for the E-Invoice platform. Enables AI agents like Claude to manage invoices, sellers, buyers, and billing through a tax-authority-compliant e-invoicing system.\n\n## Quick Start\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"einvoice\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@elyonar/einvoice-mcp\"],\n      \"env\": {\n        \"EINVOICE_API_KEY\": \"sk_live_your_key_here\",\n        \"EINVOICE_BASE_URL\": \"https://api.einvoice.ng\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `EINVOICE_API_KEY` | Yes | API key (`sk_live_...` or `sk_test_...`) |\n| `EINVOICE_BASE_URL` | No | API gateway URL (default: `https://api.einvoice.ng`) |\n| `EINVOICE_REQUEST_TIMEOUT` | No | Request timeout in ms (default: `30000`) |\n| `EINVOICE_RETRY_ATTEMPTS` | No | Max retries for failed requests (default: `3`) |\n\n## Available Tools (41)\n\n### Invoice Tools (15)\n- `create_invoice` — Create a new invoice in draft status\n- `get_invoice` — Get invoice details by ID\n- `list_invoices` — List/filter/search invoices\n- `update_invoice` — Update a draft invoice\n- `delete_invoice` — Delete a draft invoice\n- `submit_invoice` — Submit to tax authority\n- `batch_submit_invoices` — Batch submit multiple invoices\n- `retry_invoice_submission` — Retry a failed submission\n- `cancel_invoice` — Cancel an accepted invoice (creates credit note)\n- `get_invoice_status` — Get status from local DB\n- `query_invoice_status` — Query tax authority for real-time status\n- `validate_invoice` — Validate without creating\n- `download_invoice` — Get PDF/XML download URL\n- `get_invoice_statistics` — Analytics and metrics\n- `get_invoice_setup` — Reference data for invoice creation\n\n### Seller Tools (7)\n- `create_seller` — Register a new seller\n- `get_seller` — Get seller details\n- `list_sellers` — List/search sellers\n- `update_seller` — Update seller (tax number immutable)\n- `delete_seller` — Delete seller (no invoices)\n- `verify_seller_tax_no` — Trigger tax number verification\n- `get_seller_tax_verification_status` — Check tax verification status\n\n### Buyer Tools (7)\n- `create_buyer` — Register a new buyer\n- `get_buyer` — Get buyer details\n- `list_buyers` — List/search buyers\n- `update_buyer` — Update buyer (tax number immutable)\n- `delete_buyer` — Delete buyer (no invoices)\n- `verify_buyer_tax_no` — Trigger tax number verification\n- `get_buyer_tax_verification_status` — Check tax verification status\n\n### Billing Tools (12)\n- `get_billing_account` — Credit balance and account status\n- `check_balance` — Verify sufficient credits before operations\n- `get_billing_setup` — Full billing overview\n- `get_subscription_plans` — Available subscription plans\n- `get_credit_packages` — Available credit packages for purchase\n- `get_active_subscription` — Current subscription details\n- `get_subscription_history` — Past subscriptions\n- `purchase_credits` — Buy a credit package (returns checkout URL)\n- `get_payment_history` — Payment transaction history\n- `get_transaction_history` — Credit ledger (purchases, consumption, refunds)\n- `get_usage_analytics` — Submission counts, credit usage, daily breakdown\n- `get_consumption_breakdown` — Credit usage by API endpoint\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test\nnpm run dev  # run with tsx (hot reload)\n```\n\n## Architecture\n\n```\nsrc/\n├── index.ts               # MCP server entry point (stdio transport)\n├── client/\n│   ├── http-client.ts     # HTTP client with auth, retry, rate limiting\n│   ├── invoice-client.ts  # Invoice service API client\n│   └── billing-client.ts  # Billing service API client\n├── tools/\n│   ├── invoice-tools.ts   # 15 invoice tool definitions + handlers\n│   ├── seller-tools.ts    # 7 seller tool definitions + handlers\n│   ├── buyer-tools.ts     # 7 buyer tool definitions + handlers\n│   └── billing-tools.ts   # 12 billing tool definitions + handlers\n├── types/\n│   ├── invoice.ts         # Invoice/seller/buyer types\n│   └── billing.ts         # Billing/subscription/payment types\n└── utils/\n    └── format.ts          # Response formatting utilities\n```\n\n## Versioning\n\nThis project follows [Semantic Versioning](https://semver.org/) with [Conventional Commits](https://www.conventionalcommits.org/).\n\n```bash\nnpm run release         # auto-bump based on commits\nnpm run release:patch   # 0.1.0 → 0.1.1\nnpm run release:minor   # 0.1.0 → 0.2.0\nnpm run release:major   # 0.1.0 → 1.0.0\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for commit conventions, branching strategy, and how to add new tools.\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}