How to Connect Mercado Pago to an AI Agent Step by Step

· DoubleX

Quick answer

To connect Mercado Pago to an AI agent, open the Connectors screen in DoubleX Agentes, choose Mercado Pago, authorize the connection, then pick which agent uses it and which actions it can run. The connector covers documentation search, webhooks, test users, and integration review.

If you are integrating Mercado Pago into a product or store, a lot of the work is reading documentation, setting up webhooks, creating test users, and checking that everything is wired correctly. An AI agent can take over much of that repeated work. This guide shows how to connect the Mercado Pago connector, what it actually allows, and how to keep the agent on a short leash.

What can the Mercado Pago connector do for an agent?#

The Mercado Pago connector lets an agent search the Mercado Pago documentation, configure webhooks, create test users, and review your integration. It is built for people who integrate Mercado Pago, not for looking up sales or running charges.

A connector is a system linked to the platform, and agents use its tools. Here is how the Mercado Pago tools map to everyday integration work:

Integration taskHow the agent helpsConnector capability
Find the right API referenceSearches the docs and summarizes the relevant stepsDocumentation search
Receive payment notificationsSets up the webhook configurationWebhook setup
Test a checkout flowCreates buyer and seller test usersTest user creation
Check your work before launchReviews the integration and lists gapsIntegration review

What should you prepare before connecting?#

Before connecting, make sure you have a Mercado Pago account with access to the integration you want to work on, and decide who on your team will make the connection. Preparation takes a few minutes and avoids permission surprises later.

A short checklist:

  • A DoubleX Agentes account. Creating it is free and needs no card.
  • Access to your Mercado Pago account. The person connecting should be able to authorize access for the integration in question.
  • The right person connecting. A connection can be personal (valid only for that person), for the team, or for the whole company. For an integration owned by a team, a team connection is usually the better fit.
  • A clear goal. For example, "set up webhooks for payment notifications" or "review our checkout integration". A narrow goal makes it easier to choose permissions.
  • An agent to use it. You can create one from scratch, or run the diagnostic and turn the result into a team of agents with your company's instructions already in place.

If you are new to the platform, the Quickstart covers account creation and the first agent.

How do you connect Mercado Pago on the Connectors screen?#

You connect Mercado Pago from the Connectors screen by selecting it, authorizing the connection, and then assigning it to an agent. The steps below follow the real flow in DoubleX Agentes.

  1. Open Connectors in the DoubleX Agentes menu.
  2. Find Mercado Pago in the list (it sits with the finance connectors) and start the connection.
  3. Choose the scope of the connection: personal, team, or company.
  4. Authorize access with your Mercado Pago account when prompted. Credentials and tokens are stored encrypted with AES-256-GCM.
  5. Open Agents, select the agent that will handle the integration work, and add Mercado Pago to its connectors.
  6. Review the allowed actions (see the next section) and save.

For developers, the Connectors API lets you manage connectors programmatically.

How do you choose which actions the agent can run?#

For each agent, you choose which systems it uses and, inside each system, which actions it may execute. Actions that change data can stay off, leaving the agent read-only.

A sensible starting setup for Mercado Pago:

  • Leave on: documentation search and integration review. These help without changing anything.
  • Turn on carefully: webhook configuration and test user creation, since they change your setup.
  • Keep a human in the loop. Before the agent sends, deletes, or alters something in your systems, it asks for confirmation and shows the step-by-step of what it did.

Also keep these controls in mind:

  • Roles of owner, admin, and member decide who can change connections and agents.
  • Your company content is not used to train models, and requests go only to AI providers that do not train on what they receive.
  • Each company has its own separate database.

Start read-only, watch a few tasks, then enable the change actions you actually need.

How do you test the connection with a simple first request?#

Test with a low-risk request that only reads documentation or reviews your setup, then move to actions that change something. A first request that cannot alter anything confirms the connection works.

Requests you can copy:

  • "Search the Mercado Pago documentation and summarize the steps to receive payment notifications by webhook."
  • "Create a test buyer user and a test seller user so I can try our checkout."
  • "Review our Mercado Pago integration and list anything missing before we go live."
  • "Explain which webhook events we should subscribe to for payment updates, and ask me before configuring anything."

If the agent answers using the Mercado Pago tools and asks for confirmation before any change, the connection and permissions are working. For a deeper look at the next steps, read Mercado Pago with an AI Agent: Webhooks, Testing and Review.

How do you check the task history and what the agent did?#

Open the Tasks screen and select the task. Every request to an agent becomes a task with a full history: the request, each tool the agent used, and the result. You can see who asked, what was done, and when.

When reviewing a Mercado Pago task, check:

  • Which Mercado Pago tool the agent called, and in what order.
  • Whether a confirmation was requested before any change.
  • The final result, such as a created test user or a configured webhook.

If something looks wrong, tighten the agent's allowed actions or adjust its instructions and run the request again. To have an agent react to external events, see Webhooks.

Frequently asked questions#

Can the agent look up my Mercado Pago sales or charge customers?#

No. The connector covers documentation search, webhook setup, test users, and integration review. It does not offer sales lookups or charging.

Do I need to write code to connect Mercado Pago?#

No. You connect it from the Connectors screen and describe what you need in your own words. Developers who want more can use the REST API, the CLI, or the MCP server.

Can I keep the agent from changing anything?#

Yes. You choose the actions allowed per system, so you can leave change actions off and keep the agent read-only. The agent also asks for confirmation before sending, deleting, or altering anything.

Who can see what the agent did?#

Every task keeps a history with the request, each tool used, and the result. Access follows the roles and sharing settings you define for your company.

Does connecting Mercado Pago cost extra?#

Creating an account and running the first diagnostic is free. Using the AI consumes credits from your plan, and when the limit is reached, usage stops with no surprise bill.

Related guides

More Mercado Pago guides