• NEW PLAN
  • STATUS
  • AUDIT
  • MANUAL

How to manage recurring subscriptions with your AI

Connect Pagar.me to your AI client to handle billing cycles through simple chat commands. You'll move from plan setup to status checks without leaving your conversation.

Ask AI about this page

Short answer

Can I manage Pagar.me subscriptions via chat?

Yes. You can trigger new subscription setups and pull real-time status updates for existing customers. You'll see how the specific tool capabilities map to these actions below.

Subscription outcomes

What you can do

These are the specific results you get when your AI interacts with Pagar.me.

NEW PLAN

Instant plan creation

Your AI uses the available tools to register new subscription structures. This gets your billing logic live immediately.

STATUS

Real-time billing checks

Ask about any specific customer to see if their payment is active or lapsed. Your agent pulls this data directly from Pagar.me.

AUDIT

Subscription tracking

Keep tabs on your recurring revenue by querying the status of various accounts. It turns your chat window into a billing dashboard.

MANUAL

Human intervention needed

Complex billing disputes or manual refund processing require you to log in to the Pagar.me dashboard directly. The AI cannot modify sensitive financial records without your direct action.

The workflow

What your AI does when you ask for billing help.

The AI acts as a bridge between your text commands and the Pagar.me API.

  1. Initialize billing

    When you want to start a new recurring cycle, the AI prepares the necessary parameters for the new customer.

    create_subscription

  2. Verify customer status

    If you need to know if a user is still paying, the AI fetches the current state of their account.

    get_subscription

  3. Confirm plan details

    The agent checks the specific terms of an active subscription to ensure everything matches your expectations.

    get_subscription

  4. Report errors

    If a subscription cannot be found or created, the AI tells you exactly what went wrong based on the API response.

    create_subscriptionget_subscription

Try it

Copy these to start.

Use these prompts to kick off your first billing task.

Starting points

Replace the bracketed info with your actual customer IDs or plan names.

Pagar.me Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_d8ZIp00FEg3zpn3ieRdMWqLt57HQWqBBDudfBcN1/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Pagar.me capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "pagarme-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_d8ZIp00FEg3zpn3ieRdMWqLt57HQWqBBDudfBcN1/mcp"
    }
  }
}
Copy into chat04

  • Create a new subscription for customer ID 98765 with the monthly premium plan.

  • Check the current status of the subscription for user_id_4432.

  • Is the subscription for account_abc_123 still active?

  • Set up a recurring billing plan for the new enterprise client in Pagar.me.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Pagar.me once, then ask.

Just click the link to authorize the connection. Your credentials stay encrypted, and you can start chatting with your billing data immediately.

Connect Pagar.me to your AI

FAQ

How the billing task behaves

  • 01

    Can the AI cancel a subscription?

    No. The current tools only allow for creating and retrieving subscription data. You must handle cancellations in the Pagar.me dashboard.

  • 02

    Can I change the price of a plan through chat?

    No. The AI can create new subscriptions, but it cannot modify the pricing of existing ones.

  • 03

    Does the AI see my full credit card details?

    No. The AI only interacts with the subscription objects provided by the Pagar.me API.

  • 04

    Can I use this with Claude?

    Yes, as long as you are using an MCP-compatible client like Claude Desktop.

  • 05

    Will the AI delete any customer data?

    No. There are no tools available to the AI that allow for the deletion of subscriptions or customer records.

  • More questions about Pagar.me? The Connector page answers them. See everything the Pagar.me Connector can do

Connect Pagar.me to Claude, Cursor, ChatGPT & more