Skip to main content
Glama

@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_...

Related MCP server: Revenium MCP Server

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

  • 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

Available Tools

25 tools
create_customerC

Create a new customer for a product

Inputs: productId (required), externalId (required), name, email.

create_meterC

Create a meter (usage dimension) for a product

Inputs: productId (required), name (required), displayName (required), unit (required), +1 more.

create_productB

Create a new product for usage metering

Inputs: name (required), type, description.

create_webhookC

Create a webhook subscription to receive event notifications

Inputs: url (required), events (required).

delete_webhookC

Delete a webhook subscription

Inputs: webhookId (required).

generate_invoiceC

Generate an invoice for a customer's usage in a given period

Inputs: productId (required), customerId (required), periodStart (required), periodEnd (required).

get_agent_usageC

Get usage statistics for a specific agent by its slug

Inputs: slug (required).

get_invoiceC

Get detailed information about a specific invoice

Inputs: productId (required), invoiceId (required).

get_productC

Get details of a specific product including its meters

Inputs: productId (required).

get_usageB

Query aggregated usage data, optionally filtered by product, customer, or date range

Inputs: productId, customerId, startDate, endDate.

invoke_agentC

Invoke an AI agent from the Pulse marketplace with a text input

Inputs: slug (required), input (required).

list_customersC

List all customers for a product

Inputs: productId (required).

list_invoicesB

List invoices for a product, optionally filtered by status

Inputs: productId (required), status.

list_my_agentsA

List all AI agents you've published in the Pulse marketplace

Inputs: no named parameters.

list_payment_intentsB

List payment intents (attempted payments) for a specific payment link

Inputs: linkId (required).

list_productsB

List all products in your Pulse account

Inputs: no named parameters.

list_received_paymentsC

List all received payments across all payment links

Inputs: limit, offset.

list_webhooksB

List all webhook subscriptions

Inputs: no named parameters.

send_invoiceC

Send (or re-send) an invoice via email to the customer

Inputs: productId (required), invoiceId (required).

track_eventC

Track a single usage event for a customer

Inputs: meterId (required), customerId (required), value (required), timestamp, +1 more.

track_events_batchB

Track multiple usage events in a single request

Inputs: events (required).

update_customerC

Update an existing customer's details

Inputs: productId (required), customerId (required), name, email.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 25 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting specific resources and actions, such as create_customer vs. update_customer or track_event vs. track_events_batch. However, some potential ambiguity exists between list_payment_intents and list_received_payments, as both relate to payment tracking but with slightly different scopes that could confuse an agent about which to use for specific queries.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as create_customer, list_products, get_usage, and update_customer. All tools use snake_case with clear action verbs, making the set predictable and easy to navigate without any deviations in naming conventions.

    Tool Count3/5

    With 25 tools, the count is borderline high for a coherent set, as it may feel heavy and potentially overwhelming for an agent. While the tools cover a broad domain of billing, metering, and marketplace operations, the number approaches the upper limit where usability might degrade, placing it in the 16-25 range that feels borderline for typical agent interactions.

    Completeness4/5

    The tool set provides comprehensive coverage for billing, metering, and marketplace domains, including CRUD operations for customers, products, and webhooks, plus usage tracking and payment management. Minor gaps exist, such as no update or delete tools for products or meters, but agents can likely work around these with the available create and get operations without significant failures.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables access to Usage and Billing APIs for managing accounts, products, meters, plans, and usage reporting. Supports operations like creating products/plans, reporting usage, and retrieving billing information.
      18
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to generate, track, and manage invoices via MCP tools, with CLI support for payment tracking and earnings summaries.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP hosts like Claude, VS Code, Cursor, and others to discover payment methods, create payment links, verify payments, inspect invoices, and manage refunds through focused tools, with a guided safe payment workflow and a restricted generic API escape hatch.
      7
      35 npm
      MIT