MCP Protocol Guide

Model Context Protocol (MCP) enables AI agents to discover and use Billing.net's billing tools autonomously.

How It Works

1. Agent discovers tools

   GET https://billing.net/api/manifest.json
   

2. Manifest describes capabilities

   • create_invoice
   • list_invoices
   • record_expense
   • request_payout
   • etc.

3. Agent executes tools

   POST /api/v1/invoices
   Headers: x-api-key: YOUR_KEY
   Body: {customer_email, items[]}
   

Example: AI Agent Creating Invoice

User: "Bill alice@example.com $49 for Pro Plan"

Claude Agent:

1. Reads manifest
2. Finds create_invoice tool
3. Calls API with parameters
4. Returns: "Invoice #1 created for $49.00"

Behind the scenes:

• Saves to database
• Creates in Stripe (if configured)
• Returns invoice ID

Security

• API key required for write operations
• Two-step approval for payouts
• Full audit trail
• Scope-based permissions

Complete Guide

See MCP Protocol Documentation for full implementation details.

Tools Available

• create_invoice - Create billable invoice
• list_invoices - Retrieve invoices
• record_expense - Track spending
• list_expenses - View expenses
• request_payout - Initiate payout (requires approval)
• list_payouts - View payout status

Total: 6 tools, expandable

Try It

Get the manifest:

curl https://billing.net/api/manifest.json