Code with AI agents

Teach your agent how to integrate Chargefy, then connect your account when needed. For example:

Use the Chargefy skill to implement a R$ 99.90 checkout in this project, in test mode, with payment confirmation through a webhook.

Resource	What it does	Example
Skills	Guides the agent through the API, payment flows, and integration requirements.	Write a checkout using the correct fields and events.
MCP	Connects the agent to an organization’s data with the permissions you authorize.	Look up customers and inspect a test invoice.
Claude Code plugin	Bundles the same four skills, an integration reviewer, and the MCP configuration.	Review an integration before going live.

You can use the skills without connecting an account. To look up or create resources in your organization, also configure MCP.

1. Install the skills

With Node.js installed, open a terminal in your project directory and run:

npx skills add https://docs.chargefy.io --skill chargefy

The command above installs the setup, concepts, and best practices skill. Install other skills as needed using their commands in the table below. Select your agent in the installer, or choose it directly:

Claude Code
Codex
Cursor

npx skills add https://docs.chargefy.io --skill chargefy --agent claude-code

npx skills add https://docs.chargefy.io --skill chargefy --agent codex

The skills are available when Codex works in this project, through the app, terminal, or editor extension.

npx skills add https://docs.chargefy.io --skill chargefy --agent cursor

By default, installation applies to this project. Add --global to install for your user across projects. Open a conversation in the project after installation; restart the agent if the skill does not appear. Using another IDE or agent? The skills follow the open Agent Skills standard. Run the same command and select your tool from the installer’s options. Compatibility requires the IDE’s agent to support skills; installing a skill does not add that capability to an editor. See the agents supported by the installer. To verify, ask:

Read the chargefy skill and explain which flow to use to sell a course through a payment link.

Each command installs the selected skill. The agent uses the relevant instructions for each task; MCP is optional.

Included skills

Skill	What it covers	Install command
`chargefy`	Setup, concepts, modeling, and best practices.	`npx skills add https://docs.chargefy.io --skill chargefy`
`chargefy-payments`	Checkout, webhooks, and sandbox testing.	`npx skills add https://docs.chargefy.io --skill chargefy-payments`
`chargefy-billing`	Invoices, trials, proration, usage, and recovery.	`npx skills add https://docs.chargefy.io --skill chargefy-billing`
`chargefy-platforms`	Connected organizations, activation, and branding.	`npx skills add https://docs.chargefy.io --skill chargefy-platforms`

The commands above let you choose an agent in the installer. Add --agent claude-code, --agent codex, or --agent cursor to target your tool directly. For example: “Use chargefy to model a R$ 99/month Pro plan, then chargefy-billing to implement a 14-day trial.” To review existing code: “Use chargefy to check this integration for duplicate charges.”

Using Claude Code? The Chargefy plugin is an alternative with the same four skills, an integration reviewer, and MCP configured. If you choose the plugin, follow its guide: you do not need to install the skills separately or add the same MCP server again. Account authorization is still required.

2. Connect MCP

In the dashboard, open Developers → MCP and Skills and check that test access is enabled. Then configure your agent:

Claude Code
Codex
Cursor

claude mcp add --transport http chargefy https://mcp.chargefy.io

In Claude Code, type /mcp, select chargefy, and choose Authenticate to sign in with your Chargefy account.

With the Codex CLI installed, run:

codex mcp add chargefy --url https://mcp.chargefy.io
codex mcp login chargefy

Complete sign-in in your browser. Run codex mcp list to check the configuration. The app and extension use this configuration on the same computer too.

Add the server to .cursor/mcp.json in your project directory. If the file already exists, add chargefy inside mcpServers, preserving other servers:

{
  "mcpServers": {
    "chargefy": {
      "url": "https://mcp.chargefy.io"
    }
  }
}

Open Cursor’s MCP settings, find chargefy, and complete browser authentication when prompted.

On the Chargefy authorization screen, choose your organization and authorize test with read-only access to start. To create test customers, products, or links, choose read and write for that environment. You can revoke access from the dashboard at any time. You do not need to paste a secret key into the agent: these connections use your account sign-in. For other clients and API-key automations, see the full MCP guide.

3. Check the connection

Ask:

Use the Chargefy connection for reading only. Show the organization, environments, and access level. Then list up to 5 test customers. Do not change anything.

The agent should report the authorized organization and test customers. An empty list also confirms the query when no customers exist. With test write access authorized, you can ask:

Create a R$ 99.90 payment link for the Introduction to Photography course, in the test environment.

MCP supports queries and creating or editing customers, catalog items, discounts, and links. Captures, refunds, and subscription cancellation are outside its scope. The skill can guide API code for those integrations; see the available tools.

Keep the skills updated

Run the installation command again to get the current content. Keep --global if you used it initially. For the Claude Code plugin, follow its update instructions. If the skill cannot be found, check that your agent opened the directory where you installed it. If MCP connects but denies a query, check the organization, environment, and permissions in Access and permissions.

​1. Install the skills

​Included skills

​2. Connect MCP

​3. Check the connection

​Keep the skills updated

1. Install the skills

Included skills

2. Connect MCP

3. Check the connection

Keep the skills updated