mcp-proabono

MCP (Model Context Protocol) Server for the ProAbono API. Enables AI assistants to manage subscriptions, customers, invoices and more through ProAbono.

Installation

npx mcp-proabono

Or install globally:

npm install -g mcp-proabono

Configuration

The server requires the following environment variables:

| Variable | Description | |----------|-------------| | PROABONO_ID_BUSINESS | Your ProAbono Business ID (found in your ProAbono URL) | | PROABONO_API_KEY | Your ProAbono API Key | | PROABONO_API_SECRET | Your ProAbono API Secret |

Usage with Claude Desktop

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "proabono": {
      "command": "npx",
      "args": ["-y", "mcp-proabono"],
      "env": {
        "PROABONO_ID_BUSINESS": "your-business-id",
        "PROABONO_API_KEY": "your-api-key",
        "PROABONO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Available Tools

Customers

| Tool | Description | |------|-------------| | proabono_create_customer | Create a new customer | | proabono_get_customer | Retrieve a customer by reference | | proabono_list_customers | List all customers | | proabono_get_billing_address | Get customer billing address | | proabono_update_billing_address | Update customer billing address | | proabono_get_payment_settings | Get customer payment settings | | proabono_update_payment_settings | Update customer payment settings | | proabono_anonymize_customer | Anonymize customer data (GDPR) | | proabono_revoke_customer_links | Revoke customer portal links |

Usages

| Tool | Description | |------|-------------| | proabono_get_usages | Get all usages for a customer | | proabono_get_usage | Get specific feature usage | | proabono_update_usage | Update usage (increment/set) |

Features

| Tool | Description | |------|-------------| | proabono_get_features | Get features for a customer | | proabono_get_feature | Get a specific feature |

Offers

| Tool | Description | |------|-------------| | proabono_get_offers | List all offers | | proabono_get_offer | Get a specific offer |

Subscriptions

| Tool | Description | |------|-------------| | proabono_create_subscription | Create a subscription | | proabono_get_subscription | Get subscription by ID | | proabono_list_subscriptions | List subscriptions | | proabono_update_subscription_term_date | Update term date | | proabono_suspend_subscription | Suspend a subscription | | proabono_start_subscription | Start/restart a subscription | | proabono_upgrade_subscription | Upgrade to another offer | | proabono_terminate_subscription | Terminate a subscription |

Pricing

| Tool | Description | |------|-------------| | proabono_compute_pricing_usage | Compute pricing for usage update | | proabono_compute_pricing_subscription | Compute pricing for new subscription | | proabono_compute_pricing_subscription_start | Compute pricing for starting subscription | | proabono_compute_pricing_subscription_upgrade | Compute pricing for upgrade |

Balance & Billing

| Tool | Description | |------|-------------| | proabono_create_balance_line | Create a balance line | | proabono_list_balance_lines | List balance lines | | proabono_bill_customer | Generate invoice from balance |

Invoices

| Tool | Description | |------|-------------| | proabono_list_invoices | List invoices | | proabono_get_invoice | Get invoice by ID |

Example Usage

Once configured, you can ask Claude:

• "List all my ProAbono customers"
• "Create a new customer with email [email protected]"
• "What subscriptions does customer 12345 have?"
• "Upgrade subscription 789 to the premium plan"
• "Show me the invoices for customer 12345"

API Documentation

For more information about the ProAbono API, visit:

• ProAbono API Reference
• ProAbono Documentation

License

MIT