@beinfi/pulse-mcp

MCP server for the Pulse usage-based billing platform.

Track metering events, manage customers, generate invoices, and more — directly from any MCP-compatible AI assistant (Claude, Cursor, Windsurf, etc.).

Quick Start

npx @beinfi/pulse-mcp

Set your API key as an environment variable:

export PULSE_API_KEY=sk_live_...

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pulse": {
      "command": "npx",
      "args": ["-y", "@beinfi/pulse-mcp"],
      "env": {
        "PULSE_API_KEY": "sk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add pulse -- npx -y @beinfi/pulse-mcp

Then set your API key:

export PULSE_API_KEY=sk_live_...

Available Tools

Metering

• track_event — Track a single usage event for a customer
• track_events_batch — Track multiple usage events in a single request
• get_usage — Query aggregated usage data with optional filters

Products & Meters

• list_products — List all products
• get_product — Get product details including its meters
• create_product — Create a new product
• create_meter — Create a meter (usage dimension) for a product

Customers

• list_customers — List all customers for a product
• create_customer — Create a new customer
• update_customer — Update customer details

Billing

• list_invoices — List invoices for a product
• generate_invoice — Generate an invoice for a customer's usage period
• get_invoice — Get invoice details
• send_invoice — Send an invoice via email

Payment Links

• list_payment_links — List all payment links
• create_payment_link — Create a new payment link
• get_payment_link — Get payment link details
• list_payment_intents — List payment intents for a link
• list_received_payments — List all received payments

Marketplace

• list_my_agents — List your published AI agents
• get_agent_usage — Get usage stats for an agent
• invoke_agent — Invoke an AI agent with text input

Webhooks

• list_webhooks — List all webhook subscriptions
• create_webhook — Create a webhook subscription
• delete_webhook — Delete a webhook subscription

Configuration

| Environment Variable | Required | Default | Description | |---|---|---|---| | PULSE_API_KEY | Yes | — | Your Pulse API key (sk_live_... or sk_test_...) | | PULSE_BASE_URL | No | https://api.beinfi.com | API base URL |

License

MIT