mcp · billingserv — Claude Code MCP server: BillingServ data in the chat
The BillingServ MCP server lets your assistant read customers, invoices and orders from your billing system. Useful when the answer has to come from live records.
claude mcp add --env BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> --env BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> --env BILLINGSERV_TIMEOUT_MS=<BILLINGSERV_TIMEOUT_MS> --transport stdio billingserv-mcp -- npx -y @billingserv/mcp-serverWhat mcp does
The server talks to BillingServ API v2 and exposes three tools. billingserv_list_endpoints shows which endpoints exist and what parameters they take. billingserv_get calls an allowed GET endpoint, while billingserv_create writes through POST endpoints and also handles software licence activation and validation.
Reads and writes sit in separate tools on purpose. You can leave lookups open and still put an approval step on billingserv_create in the client. Only a fixed allowlist of endpoints is reachable, and it is checked on every request. Deleting records and taking payments are left out, so the assistant cannot go that far.
You need Node.js 20 or newer, which ships npx, plus a BillingServ API key. Three environment variables drive the config: BILLINGSERV_API_BASE_URL pointing at your API v2 base, BILLINGSERV_API_KEY, and an optional BILLINGSERV_TIMEOUT_MS set to 15000 by default. A wrong base URL or a missing key means the server simply will not serve queries.
What it helps with
- list customers with unpaid invoices for the month
- read the revenue trend for the year
- check which packages a customer owns and what they can switch to
- validate a software licence activation
- open a ticket or draft an invoice from the chat
Example prompts for the agent
- Which customers have unpaid invoices this month?
- Show the revenue trend for this year from BillingServ reports
- Validate this licence and create a ticket if it fails
How to install mcp
Platform CLI
claude mcp add --env BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> --env BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> --env BILLINGSERV_TIMEOUT_MS=<BILLINGSERV_TIMEOUT_MS> --transport stdio billingserv-mcp -- npx -y @billingserv/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add billingserv-mcp --env BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> --env BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> --env BILLINGSERV_TIMEOUT_MS=<BILLINGSERV_TIMEOUT_MS> -- npx -y @billingserv/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"billingserv-mcp": {
"command": "npx",
"args": [
"-y",
"@billingserv/mcp-server"
],
"env": {
"BILLINGSERV_API_BASE_URL": "<BILLINGSERV_API_BASE_URL>",
"BILLINGSERV_API_KEY": "<BILLINGSERV_API_KEY>",
"BILLINGSERV_TIMEOUT_MS": "<BILLINGSERV_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"billingserv-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@billingserv/mcp-server"
],
"env": {
"BILLINGSERV_API_BASE_URL": "<BILLINGSERV_API_BASE_URL>",
"BILLINGSERV_API_KEY": "<BILLINGSERV_API_KEY>",
"BILLINGSERV_TIMEOUT_MS": "<BILLINGSERV_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> -e BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> -e BILLINGSERV_TIMEOUT_MS=<BILLINGSERV_TIMEOUT_MS> billingserv-mcp npx -y @billingserv/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run `claude mcp add mcp -e BILLINGSERV_API_BASE_URL=<BILLINGSERV_API_BASE_URL> -e BILLINGSERV_API_KEY=<BILLINGSERV_API_KEY> -- npx -y @billingserv/mcp-server`, then restart Claude.
What does mcp do?
It connects your assistant to BillingServ API v2: it lists the allowed endpoints, reads data with billingserv_get and writes with billingserv_create.
Can I keep lookups open but gate the writes?
Yes. The server splits reads and writes into different tools, so your client can ask for confirmation only on billingserv_create.
Similar MCP servers
All MCP servers for Finance and business →mcp by other authors comes first.
