Connect an AI agent

AI agent access is a way to connect an AI agent, such as Claude Code or Cursor, to your BuyingGroupPro account with an API key. You make the key in BuyingGroupPro, add it to the agent, and then ask the agent about your orders in plain words. AI agent access is part of the Pro and Concierge plans and the free Pro trial.

Make a key

1. Open Settings and select AI agents & API.
2. Enter a name for the key, for example the agent and the computer you use it on.
3. Choose the access. A Read key lets the agent read your data. A Read and write key also lets it use write tools. A write tool is a tool that adds or changes your data.
4. Choose when the key expires: in 30 days, 90 days or 1 year.
5. Select Make key and copy the key. BuyingGroupPro shows it only one time.

Add the key to Claude Code

Run this command. Put your key in place of YOUR_KEY. Do not put brackets or quotes around the key.

claude mcp add --transport http buyinggrouppro https://www.buyinggrouppro.com/mcp --header "Authorization: Bearer YOUR_KEY"

Do not add the option --scope project. It saves the key in a project file, and that file can go into a shared repository.

Add the key to Cursor

Open the file ~/.cursor/mcp.json in your home folder. Make the file if it does not exist. Add this server, and put your key in place of YOUR_KEY.

{
  "mcpServers": {
    "buyinggrouppro": {
      "url": "https://www.buyinggrouppro.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Use the file in your home folder, not a .cursor folder in a project, so that the key does not go into a shared repository.

Connect ChatGPT

ChatGPT signs in to BuyingGroupPro, so it does not use a key. Your ChatGPT plan and workspace must allow custom MCP servers.

1. In ChatGPT on the web, open Plugins. Select the plus button, then select Add custom MCP server.
2. Enter a name, and enter the MCP server URL https://www.buyinggrouppro.com/mcp.
3. For authentication, select the sign-in option, not an API key. In BuyingGroupPro, Settings > AI agents & API shows the name of the option.
4. Read the warning, select I understand and want to continue, then select Create as a plugin.
5. Sign in to BuyingGroupPro, choose Read or Read and write, then select Connect.

What ChatGPT reads from your account goes to OpenAI. To disconnect ChatGPT, open Settings, select AI agents & API, then select Disconnect on the ChatGPT row.

Other agents and scripts

For another agent, add an MCP server with the URL https://www.buyinggrouppro.com/mcp and the header Authorization: Bearer YOUR_KEY. The agent must let you set your own header.

A script can use the API at https://www.buyinggrouppro.com/api/agent/v1/ with the same header. Each tool is a POST with a JSON body. For example:

curl -X POST https://www.buyinggrouppro.com/api/agent/v1/get_summary -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{}'

A GET to https://www.buyinggrouppro.com/api/agent/v1/ with the same header lists the tools and their inputs.

What the agent can do

Every key can read your money summary, reports, orders, payouts, deals, commitments, review queue, alerts, alert rules and buying groups. It can also read your settings and the state of your connections. It can read your gift cards, bank bonuses, address variations (jig), perks and saved views. It can also read your Amazon order history uploads. A report has the same numbers as the website.

A Read and write key can also do these things when you ask:

• Orders: add orders, up to 100 at one time. Change an order, or change 1 field on up to 100 orders at one time. Mark orders paid or unpaid, change a paid date, use a suggested number, dismiss a flag or hide orders.
• Tracking numbers: add, change or remove the tracking numbers on your orders.
• Receipts and buying group records: link a saved receipt or record to an order, or unlink it.
• Review queue: import or ignore rows, put ignored rows back, and change a row before you import it.
• Alert rules and deal watches: make, change or hide a deal alert rule. On Concierge, start or stop a deal watch.
• Buying groups: add a buying group of your own, or change or hide a buying group that you added.
• Warehouse addresses and email aliases: add, change or remove the addresses, ship-to names and email aliases that you saved for a buying group.
• Commitments and months: add a commitment, or hide a commitment that you added. Close a month on the Reconciliation page.
• Settings: turn Auto-link orders and Skip review queue on or off, and change your manual sync lookback, your monthly profit goal, celebrations and your notifications. Change your time zone, your name, your default cash back and the settings of each inbox. Close a notice.
• Stores, accounts and cards: add one, or change one. Set the cash back % of any store. Orders from that store with no cash back then get that %.
• Gift cards, bank bonuses and address variations: add, change or hide them. Add a gift card store or a gift card buyer.
• Saved views: add or change a saved view of the Orders page.
• Perks, alerts and the roadmap: mark perks redeemed or dismissed, mark alerts read, and vote for a roadmap item.
• Amazon uploads: run Add these details or Mark as cancelled on the orders of an Amazon order history upload.

These rules apply:

• BuyingGroupPro sends the tracking numbers that the agent adds to your buying group only when Auto-submit tracking or Auto-file BFMR insurance is on.
• After BuyingGroupPro sends the tracking of an order to your buying group, the agent can add tracking numbers to that order, but it cannot remove or replace them.
• On an order with a tracking number or a BFMR link, the agent can change every field except the buying group and the order number. It can also mark that order paid or unpaid. The same rule applies to an order whose tracking BuyingGroupPro sent to your buying group.
• The agent can change the status only from and to Ordered, Shipped, Delivered, Processed, Returned, Cancelled, Deadline or Set Aside.
• The agent can import a review queue row only if the row has an order number, no tracking number and no matching order. It cannot change the tracking number of a row.
• The agent can turn Auto-submit tracking, Auto-file BFMR insurance, Email auto-sync, Discord deal alerts and auto-payout off. It cannot turn them on.
• The agent can make the Auto-insure minimum higher. It cannot make it lower.
• The agent can make an inbox read less email: fewer stores or a shorter date range. It cannot make it read more.
• The agent cannot change your time zone while auto-payout is on.
• When the agent changes a review queue row, the row stays in the review queue.
• When the agent hides an item, the item goes out of your lists and totals. You can restore it in Settings for 30 days.
• The agent cannot hide an order that is linked to a buying group receipt, a BFMR reservation or a commitment, or that BuyingGroupPro sent to a buying group.
• For 30 days after the agent unlinks a record from an order, it cannot hide that order.
• The agent can hide only the commitments that you added.
• The agent cannot write gift card numbers, PINs or bank bonus links. It sees only the last 4 characters of a gift card number, and whether a PIN or a bank bonus link is saved. It never sees the full number, the PIN or the link.
• The agent cannot reserve deals, request payouts, send emails or Discord messages, or start a sync.
• The agent cannot connect or disconnect a buying group, an inbox, the Chrome extension or Discord.
• The agent cannot change your plan, billing, password, email address, two-factor settings or keys. It cannot delete an order or an alert rule.

Limits

All your keys together can read 300 times in 1 hour. Up to 60 of these reads can be reports. They can write 10 times in 1 minute and 300 times in 1 day. Each day (Eastern time), all your keys together can:

• mark up to 300 orders paid and up to 50 orders unpaid
• import up to 500 orders
• change the tracking numbers on up to 200 orders
• change up to 300 orders in bulk, and dismiss flags on up to 200 orders
• use up to 100 suggested numbers
• hide up to 200 items
• ignore up to 100 review queue rows, put back up to 100 rows, and change rows 100 times
• link or unlink records 100 times
• make up to 20 new alert rules, and start or stop deal watches 30 times
• change settings 50 times
• add or change stores 50 times, and write the cash back % of a store on up to 500 orders
• add or change up to 200 gift cards, and add up to 20 gift card stores and buyers
• change bank bonuses 20 times and address variations 50 times
• add up to 50 commitments and close up to 12 months
• change saved views 20 times
• mark up to 100 perks, mark alerts read 50 times, and vote 30 times on the roadmap

Stay in control

• Set your agent to ask you before it uses a write tool. If the agent runs tools without asking, it can change your data with no prompt.
• Settings > AI agents & API lists the last 50 changes that an agent made. You can undo most of them there.
• An item that an agent hid shows there with a Restore button for 30 days. After 30 days, contact support to restore it.
• You cannot undo a new store, account, card or saved view there. If you do not want it, delete it in Settings. Delete a saved view on the Orders page.
• You cannot undo an alert that the agent marked read. A read alert stays in your list.
• Some AI apps load only part of a long tool list. If a tool is missing, turn off tools that you do not use in the app. The tools for saved views, deal watches, gift cards, bank bonuses, address variations, perks, alerts and the roadmap come last.
• Revoke a key to stop an agent at once. All your keys stop working when you change your password, your email address or your two-factor settings.
• We email you each time a key is made. If you did not make a key, revoke it and change your password.
• The company that makes your agent keeps your chats under its own terms. Our privacy policy tells you more.