Skip to main content
Connect your AI tools to Hyperline using the Model Context Protocol (MCP), an open standard that lets AI assistants interact with your billing data, manage customers, and automate revenue operations.

​
What is Hyperline MCP?

Hyperline MCP is our hosted MCP server that gives AI tools secure access to your Hyperline account. It’s designed to work seamlessly with popular AI assistants like Claude, ChatGPT, Cursor, and more.

​
Why use Hyperline MCP?

  • Natural language billing management — Manage customers, subscriptions, and invoices through conversational AI instead of navigating through multiple screens
  • Full account access — AI tools can search, read, create, and update records across your Hyperline account—customers, subscriptions, invoices, products, and usage data
  • Easy setup — Connect through OAuth with one-click installation for supported AI tools, or use an API token for direct authentication
  • Optimized for AI — Built specifically for AI agents with efficient data formatting and human-readable responses
  • Secure by design — Authenticates with your Hyperline credentials, with read operations auto-approved while write operations request confirmation

​
What can you do with Hyperline MCP?

  • Customer management — Look up customer details, find contacts by email or name, and create new customer records
  • Subscription operations — View active subscriptions, check renewal dates, and manage subscription lifecycle
  • Invoice handling — Search invoices by status, view payment history, and track overdue payments
  • Usage tracking — Query usage data, check consumption metrics, and explore billing periods
  • Revenue analytics — Access MRR, ARR, and other key metrics through natural language queries
  • Product catalog — Browse products and pricing, understand your catalog structure

​
Getting started

​
Prerequisites

Before connecting Hyperline MCP, ensure you have:
  1. An active Hyperline account
  2. An MCP-compatible AI client (Claude, ChatGPT, Cursor, VS Code, etc.)

​
Authentication

The Hyperline MCP server uses OAuth 2.0 for authentication. Most AI clients handle the OAuth flow automatically — you’ll simply be redirected to log in with your Hyperline credentials. If your client doesn’t support OAuth (for example, in a server or machine-to-machine context), you can authenticate using an API token instead. API tokens can be generated from your workspace Settings.

​
Connecting to Hyperline MCP

Add the following server URL to your AI client: 
https://mcp.hyperline.co/mcp
For sandbox environments, use https://sandbox.mcp.hyperline.co/mcp instead.
For Claude Desktop or Claude.ai:
  1. Open Settings → Connectors
  2. Click Add custom connector
  3. Enter a name (e.g., hyperline) and the URL: https://mcp.hyperline.co/mcp
  4. Follow the OAuth prompts to log in to your Hyperline account
Once connected, you’ll be authenticated with access to your Hyperline account data.
If your MCP client runs in a server environment without a browser (e.g., a backend agent or automated pipeline), you can skip OAuth and authenticate directly with an API key.Generate an API key from your workspace Settings, then pass it in the Authorization header when connecting to the MCP server:
Authorization: Bearer <YOUR_API_KEY>
For example, in an MCP client configuration that supports custom headers:
{
  "mcpServers": {
    "hyperline": {
      "url": "https://mcp.hyperline.co/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Keep your API key secret. Do not commit it to version control — use environment variables or a secrets manager instead.

​
Supported tools

The Hyperline MCP server exposes over 100 tools covering the full breadth of your billing operations. These include listing and retrieving customers, quotes, subscriptions, invoices, and product information, as well as actions like creating and voiding invoices, generating quotes, assigning subscriptions, querying usage data, and accessing revenue metrics — among many others. Once connected, your AI assistant automatically discovers all available tools. Simply describe what you need in natural language, and the assistant will use the right tools to get it done.

​
Sample Prompts

​
Customer & Account Lookup

PromptWhat it does
”Find all customers with overdue invoices”Searches for customers with unpaid invoices past due date
”What’s the email for Acme Corp?”Looks up contact information for a specific customer
”Show me everything we know about customer X”Retrieves comprehensive customer information
”Find customers in the Enterprise plan”Filters customers by subscription plan
”List customers created in the last 30 days”Shows recently acquired customers

​
Subscriptions & Billing

PromptWhat it does
”What subscriptions does Acme Corp have?”Lists all subscriptions for a customer
”Show me subscriptions renewing next week”Finds upcoming renewals
”Which customers are on the Pro plan?”Lists customers filtered by plan
”Create a subscription for customer X on the Starter plan”Creates a new subscription

​
Invoices & Payments

PromptWhat it does
”List unpaid invoices from the last 30 days”Searches for outstanding invoices
”What’s the total amount billed this month?”Calculates monthly billing total
”Show me the payment history for Acme Corp”Retrieves customer payment records
”Find invoices over $10,000”Filters invoices by amount

​
Revenue Analytics

PromptWhat it does
”What’s my current MRR?”Returns Monthly Recurring Revenue
”Show me revenue trends for the last quarter”Displays revenue metrics over time
”How many active subscriptions do we have?”Counts active subscriptions
”What’s our customer churn this month?”Calculates churn metrics

​
Security Best Practices

Treat your credentials and billing data as sensitive information. Only connect to AI applications you trust, and use sandbox credentials when experimenting.

​
Tool safety

Hyperline MCP uses MCP safety annotations:
  • Read operations — Auto-approved for seamless searching and viewing
  • Write operations — Request user confirmation before creating or updating data

​
User permissions

Hyperline MCP respects your existing user permissions. The tools available through the MCP server depend on the roles and permissions configured for your user account in your workspace Settings, or API key scopes. AI assistants can only access and modify what you are authorized to do in Hyperline. You can revoke access at any time by deleting API keys or revoking user access.

​
Rate limits

Standard API rate limits apply to all MCP operations. See Rate Limiting for details. In most cases, normal conversational use stays well within rate limits.

​
Troubleshooting

If your AI assistant can’t connect to Hyperline:
  1. Verify your credentials — Make sure the credentials are correct and haven’t been regenerated or revoked
  2. Check the environment — Ensure you’re using the correct URL for your environment (production vs sandbox)
  3. Test the connection — Try a simple request like “List customers” to verify the connection works
  4. Check permissions — Ensure your Hyperline user has the necessary permissions for the operations you’re attempting
Is something still unclear? Don’t hesitate to reach out to our team via the in-app chat if you need additional support.