How to integrate Proabono MCP with Claude Code

Manage your Proabono directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns. You can do this in two different ways: Via Composio Connect - Direct and easiest approach Via Composio SDK - Programmatic approach with more control

Proabono logoProabono
Basic

Proabono is a smart subscription management platform that automates billing and recurring payments. It streamlines your subscription operations and customer lifecycle.

67 Tools

Introduction

Manage your Proabono directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

Also integrate Proabono with

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Proabono to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Proabono MCP server, and what's possible with it?

The Proabono MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Proabono account. It provides structured and secure access so your agent can perform Proabono operations on your behalf.

Connecting Proabono via Composio SDK

Composio SDK is the underlying tech that powers Rube. It's a universal gateway that does everything Rube does but with much more programmatic control. You can programmatically generate an MCP URL with the app you need (here Proabono) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Proabono account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['proabono'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http proabono-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Proabono. This URL will be used to connect Claude Code to Proabono.

What's happening

  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Proabono
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Proabono MCP to Claude Code

bash
claude mcp add --transport http proabono-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (proabono-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Proabono MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your proabono-composio entry in the list
  • This confirms that Claude Code can now access Proabono tools

If everything is wired up, you should see your proabono-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Proabono

The first time you try to use Proabono tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Proabono
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Proabono authorization flow
  • Return to the terminal and start using Proabono through Claude Code

Once authenticated, you can ask Claude Code to perform Proabono operations in natural language. For example:

  • "List all active subscriptions for a customer"
  • "Create a new subscription for Acme Corp"
  • "Show overdue invoices for a specific customer"

Complete Code

Here's the complete code to get you started with Proabono and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['proabono'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http proabono-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Proabono with Claude Code using Composio's MCP server. Now you can interact with Proabono directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Proabono operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Proabono operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Proabono action and event your agent gets out of the box.

Anonymize Customer

Tool to anonymize a customer for GDPR compliance.

Bill Customer

Tool to trigger billing for a customer.

Create Customer

Tool to create or declare a customer in ProAbono via the Backoffice API.

Create Feature

Tool to create a new feature in ProAbono via the Backoffice API.

Delete Customer

Tool to delete a customer from ProAbono by ID.

Delete Offer

Tool to delete an offer from ProAbono by ID.

Delete Pricing Table

Tool to delete a pricing table from ProAbono by its ID.

Delete Pricing Table Offer

Tool to delete a pricing table offer via the ProAbono Backoffice API.

Delete Subscription Discount

Tool to delete a subscription discount via the Backoffice API.

Enable Webhook

Tool to enable a webhook in ProAbono via the Notification API.

Get Customer by ID

Tool to retrieve a single customer by ID from ProAbono Backoffice API.

Get Customer Billing Address

Tool to retrieve a customer's billing address via the Backoffice API.

Get Customer Billing Address by Reference

Tool to retrieve the billing address for a customer by reference from ProAbono API.

Get Customer by Reference

Tool to retrieve a customer by their reference identifier from ProAbono API.

Get Customer Payment Settings

Tool to retrieve customer payment settings via the Backoffice API.

Get Discount

Tool to retrieve a discount by ID via the Backoffice API.

Get Feature by ID

Tool to retrieve a feature by ID from ProAbono Backoffice API.

Get Feature by Reference

Tool to retrieve a single feature by its reference from ProAbono API.

Get Invoice

Tool to retrieve a specific invoice or credit note by ID from ProAbono.

Get Offer by ID

Tool to retrieve a single offer by its ID from ProAbono Backoffice API.

Get Subscription by Customer Reference

Tool to retrieve a subscription by customer reference from ProAbono.

Get Subscription Creation Quote

Tool to get a pricing quote for creating a new subscription without actually creating it.

Get Usage Record

Tool to retrieve a single usage record for a specific feature and customer combination from ProAbono.

Get Usages for Customer

Tool to retrieve usage data for customers from ProAbono.

Invalidate Customer

Tool to invalidate a customer by their reference.

Invalidate Customer by ID

Tool to invalidate a customer by their ProAbono internal ID.

List Balance Lines

Tool to list all balance lines from ProAbono.

List Businesses

Tool to list all businesses from ProAbono via the Backoffice API.

List Business Localization

Tool to list localization entries by business from ProAbono via the HostedPages API.

List Customer Moves

Tool to list all customer balance moves via the ProAbono Backoffice API.

List Customers

Tool to list all customers from ProAbono via the Backoffice API.

List Customers by Feature

Tool to list customers that have access to a specific feature via the ProAbono API.

List Discounts

Tool to list all discounts from ProAbono's Backoffice API.

List Features

Tool to list all features via the ProAbono Backoffice API.

List Features (V1)

Tool to retrieve all features from ProAbono API using the /v1/Features endpoint.

List Gateway Accounts

Tool to list payment gateway accounts from ProAbono Backoffice API.

List Gateway Permissions

Tool to list gateway permissions from ProAbono API.

List Gateway Requests

Tool to list gateway requests from ProAbono.

List Gateway Transactions

Tool to list gateway transactions from ProAbono.

List Invoice Lines

Tool to list all invoice lines from ProAbono via the Backoffice API.

List Invoices and Credit Notes

Tool to list all invoices and credit notes from ProAbono Backoffice API.

List Invoices by Customer Reference

Tool to list invoices for a specific customer by their reference identifier from ProAbono API.

List Offers

Tool to list all subscription offers (plans) from ProAbono Backoffice API.

List Payments

Tool to list all payments from ProAbono Backoffice API.

List Pricing Table Offers

Tool to list all pricing table offers via the ProAbono Backoffice API.

List Pricing Tables

Tool to list all pricing tables from ProAbono Backoffice API.

List Segment Localizations

Tool to list localization entries by segment from ProAbono Backoffice API.

List Segments

Tool to list all segments from ProAbono via the Backoffice API.

List Subscription Discounts

Tool to list all subscription discounts via the ProAbono Backoffice API.

List Subscription Features

Tool to list all subscription features via the ProAbono Backoffice API.

List Subscription Periods

Tool to list all subscription periods (billing cycles) from ProAbono Backoffice API.

List Subscriptions

Tool to list all subscriptions from ProAbono via the Backoffice API.

List Subscriptions (V1)

Tool to retrieve all subscriptions from ProAbono API using the /v1/Subscriptions endpoint.

List Tax Profile Exceptions

Tool to list tax profile exceptions from ProAbono Organization API.

List Tax Profiles

Tool to list all tax profiles from ProAbono via the Backoffice API.

List Upgrade Offers

Tool to retrieve offers available to upgrade an existing customer subscription.

List Webhook Notifications

Tool to list webhook notifications from ProAbono via the Notification API.

List Webhooks

Tool to list webhooks from ProAbono Notification API.

Quote Balance Line Creation

Tool to get a pricing quote for creating a balance line (one-time charge or credit).

Revoke Customer Portal Links

Tool to revoke encrypted customer portal links and generate new ones in ProAbono.

Update Business Billing Address

Tool to update business billing address via the Backoffice API.

Update Customer

Tool to update an existing customer in ProAbono via the Backoffice API.

Update Customer Billing Address

Tool to update the billing address for a customer in ProAbono via the API.

Update Customer Payment Settings

Tool to update payment settings for a specific customer in ProAbono.

Update Customer Shipping Address

Tool to update customer shipping address via the Backoffice API.

Update Feature

Tool to update an existing feature in ProAbono via the Backoffice API.

Update Tax Profiles

Tool to update an existing tax profile in ProAbono via the Backoffice API.

FAQ

Frequently asked questions

With a standalone Proabono MCP server, the agents and LLMs can only access a fixed set of Proabono tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Proabono and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Proabono tools.

Yes, absolutely. You can configure which Proabono scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Proabono data and credentials are handled as safely as possible.

Start with Proabono.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Proabono tool your agent needs.Free to start.

Start building