# three.ws Billing

Lets an autonomous agent check its three.ws plan limits, metered usage invoices, and individual transaction receipts via stdio.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Author: nirholas
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/three.ws/tree/HEAD/packages/billing-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/threews-billing

## What it does

This server connects an AI coding agent to the live three.ws billing endpoint. Through stdio calls, the agent inspects account ceilings, remaining MCP call volume, and storage without human intervention. Financial figures appear both in USDC atomic units and human-readable USD strings.

Available tools include `get_billing_summary` for plan quotas, `query_usage` for monthly itemized statements, and `export_billing_history` for CSV payloads. Specific charges resolve through `get_receipt` using an event ID or purchase ID. Public platform fees are exposed through `get_fee_info`.

Without an active `__Host-sid` cookie assigned to `THREE_WS_SESSION`, account-scoped tools immediately return a 401 error. The server remains strictly read-only: it reveals billing analytics but lacks any capability to execute transfers or alter subscription plans.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS`, `THREE_WS_SESSION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --transport stdio billing-mcp -- npx -y @three-ws/billing-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add billing-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> -- npx -y @three-ws/billing-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "billing-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/billing-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_SESSION": "<THREE_WS_SESSION>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "billing-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/billing-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_SESSION": "<THREE_WS_SESSION>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -e THREE_WS_SESSION=<THREE_WS_SESSION> billing-mcp npx -y @three-ws/billing-mcp
```
Replace <…> with your own values

## When to use it
- inspect current plan ceilings and daily MCP call allowances
- retrieve line-item usage summaries for a billing period
- export account expense statements directly to CSV
- look up settlement receipts by transaction event ID

## Example prompts
- Check our current three.ws quota ceilings and remaining calls.
- Fetch an itemized usage breakdown for the current calendar month.
- Look up the charge receipt corresponding to event_id 4091.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [nirholas/three.ws](https://affpapa.org/en/nevibecode/by/nirholas/three.ws.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md