three.ws Billing
An agent's account economics — plan quotas, metered usage, invoices, receipts, and…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.3
- Listing updated
- 5 days ago
About three.ws Billing
three.ws Billing is an open-source MCP server. It runs locally on your machine and is started by your AI client.
An agent's account economics — plan quotas, metered usage, invoices, receipts, and earnings.
Install
Run in a terminal
claude mcp add billing-mcp --env THREE_WS_SESSION='<THREE_WS_SESSION>' -- npx -y @three-ws/billing-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"billing-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/billing-mcp"
],
"env": {
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"billing-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/billing-mcp"
],
"env": {
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"billing-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/billing-mcp"
],
"env": {
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"billing-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/billing-mcp"
],
"env": {
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"billing-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/billing-mcp"
],
"env": {
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Configuration
THREE_WS_BASEBase URL of the three.ws API that serves the billing endpoints. Override only when self-hosting or targeting a preview deployment.THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the live three.ws API reads.THREE_WS_SESSIONYour three.ws session token (the value of the `__Host-sid` cookie from a signed-in browser). REQUIRED: it exposes private billing data, so every account-scoped read (get_billing_summary, query_usage, export_billing_history, get_receipt) resolves the calling user from it and returns only your data. Only the public get_fee_info works without it. Treat like a password.Required
Pricing
Open source
Prices change. Check three.ws before you buy.
three.ws Billing FAQ
Is three.ws Billing free?
Yes. three.ws Billing is open source, so you can use and self-host it for free.
How do I add three.ws Billing to Claude Code?
Run this command in your terminal: claude mcp add billing-mcp --env THREE_WS_SESSION='<THREE_WS_SESSION>' -- npx -y @three-ws/billing-mcp