How to integrate Proabono MCP with Atomic Agent

Connect Atomic Agent to Proabono MCP. List all active subscriptions for a customer, create a new subscription for acme corp, and more using natural language, with authentication handled for you.

Proabono logoProabono
Basic

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

64 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Proabono.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Proabono account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Proabono with

How Atomic Agent connects to Proabono

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Proabono to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Proabono. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Proabono account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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 to your customers, subscriptions, offers, invoices, payments, and features, so your agent can create and update customers, review subscriptions, inspect billing activity, and compare offers on your behalf.

  • Customer account management: Have your agent create customers, find existing customer records, update account details, and review billing addresses.
  • Subscription monitoring: Let the agent list subscriptions or find the subscription associated with a specific customer.
  • Invoice and payment review: Direct your agent to list payments, inspect invoices and credit notes, or retrieve a specific billing document.
  • Offer and feature discovery: Instruct your agent to list available subscription offers and features, then retrieve more details about a selected offer.
  • Payment settings and discounts: Have your agent review or update customer payment settings and remove discounts from subscriptions when needed.

Use Proabono from Atomic Agent

With your account connected, ask Atomic Agent to work with Proabono in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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

Bills a customer's balance using the customer reference, normally creating an invoice for all available balance lines.

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

Delete a subscription discount by its ID via the ProAbono Backoffice API.

Enable Webhook

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

Get Customer by ID

Requests a single customer by ID using the ProAbono Live 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

Retrieves a customer's payment settings by customer reference through the ProAbono Live API, including payment method type and next billing date.

Get Discount

Retrieve a specific discount by ID and business ID from the ProAbono Backoffice API.

Get Feature by ID

Retrieve a ProAbono feature by ID to inspect its details, such as its name, type, visibility, and lifecycle state.

Get Invoice

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

Get Offer by ID

Request details of a single ProAbono offer using an offer ID and business ID.

Get Subscription by Customer Reference

Retrieve a customer's active subscription by customer reference.

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

Invalidate a customer by reference, replacing the customer reference so it can be reused and revoking existing portal links.

Invalidate Customer by ID

Tool to invalidate a customer by their ProAbono internal ID.

List Balance Lines

List ProAbono balance lines for a customer reference or subscription ID, with pagination.

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

Lists customer balance moves through the ProAbono Backoffice API, with pagination and filters for customer, unbilled status and minimum update date.

List Customers

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

List Customers by Feature

List customers with active subscriptions containing a specified feature, with feature usage and billing-period details.

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

List a page of invoice lines from the ProAbono Backoffice API, optionally filtered by business, invoice, or minimum amount.

List Invoices and Credit Notes

List invoices and credit notes from the ProAbono Backoffice API, with pagination and optional filters for business, technical invoice state, and minimum payment date.

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

List subscription-discount associations for a business 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 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

List offers for a customer by reference, with optional pagination and an UpgradeOnly query parameter.

List Webhook Notifications

List webhook notification history for a business, with optional segment, date range, state, or webhook ID filters.

List Webhooks

Tool to list webhooks from ProAbono Notification API.

Quote Balance Line Creation

Request a pricing quote for a customer's proposed balance line, such as a 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

Update a customer's payment method using their customer reference 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

Start with Proabono.It takes 30 seconds.

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

Start building