# @beinfi/pulse-mcp

MCP server for the [Pulse](https://beinfi.com) 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

```bash
npx @beinfi/pulse-mcp
```

Set your API key as an environment variable:

```bash
export PULSE_API_KEY=sk_live_...
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

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

### Claude Code

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

Then set your API key:

```bash
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