home / mcp / pulse mcp server

Pulse MCP Server

Provides an MCP server to track metering, manage customers, generate invoices, and handle Pulse billing workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "be-infinitum-pulse-mcp": {
      "url": "https://mcp.pulse.example/api/mcp",
      "headers": {
        "PULSE_API_KEY": "sk_live_...",
        "PULSE_BASE_URL": "https://api.beinfi.com"
      }
    }
  }
}

You can run the Pulse MCP Server to enable metering, customer management, invoicing, and related billing actions directly from MCP-compatible assistants. This server exposes a simple, local runtime you start with a single command and an API key, making it easy to integrate Pulse billing capabilities into your AI-enabled workflows.

How to use

To use the Pulse MCP Server, start the runtime with your MCP client and provide your Pulse API key. You can connect from Claude or other MCP clients by configuring the server as an MCP endpoint and supplying your key. Once running, you can track usage, manage customers, generate invoices, and perform related billing tasks through your client.

Typical usage pattern: - Start the MCP runtime with the included command. - Set your API key in the environment to authorize requests. - Connect your MCP client (such as Claude) using the provided configuration snippet or CLI command. - Use the available tools to track events, manage products and meters, handle billing, and work with invoices and payments.

How to install

Prerequisites:
- Node.js installed on your machine (and npm or a compatible package manager).
- Access to the internet to install dependencies and reach the Pulse API.

Install and run the Pulse MCP Server using the runtime command shown here.

Commands you will run:
- Install and start the MCP server with npx:

npx @beinfi/pulse-mcp

Configuration and usage notes

Environment variable to authorize with Pulse: - PULSE_API_KEY: Your Pulse API key (starts with sk_live_ or sk_test_). This is required.

Optional base URL for Pulse API (defaults to https://api.beinfi.com): - PULSE_BASE_URL: API base URL

Available tools

track_event

Record a single usage event for a customer to count towards metered usage.

track_events_batch

Submit multiple usage events in a single request to minimize API calls.

get_usage

Query aggregated usage data with optional filters to analyze consumption.

list_products

Retrieve all products configured in Pulse.

get_product

Get details about a product, including its meters.

create_product

Create a new product in Pulse.

create_meter

Create a new meter (usage dimension) for a product.

list_customers

List all customers associated with a product.

create_customer

Create a new customer in Pulse.

update_customer

Update details for an existing customer.

list_invoices

List invoices for a product.

generate_invoice

Generate an invoice for a customer’s usage period.

get_invoice

Retrieve details for a specific invoice.

send_invoice

Send an invoice via email to a customer.

list_payment_links

List all payment links you've created.

create_payment_link

Create a new payment link for invoicing or checkout.

get_payment_link

Get details of a specific payment link.

list_payment_intents

List payment intents associated with a payment link.

list_received_payments

List all payments received for your accounts.

list_my_agents

List your published AI agents in the marketplace.

get_agent_usage

Get usage statistics for an AI agent.

invoke_agent

Invoke an AI agent with text input to perform actions.

list_webhooks

List all webhook subscriptions.

create_webhook

Create a new webhook subscription.

delete_webhook

Delete a webhook subscription.