--- title: "MCP" description: "Connect an AI agent to Inttegro and use commerce tools safely." canonical: "https://studio.inttegro.com/inttegro-mcp" format: inttegro-machine-docs/v1 language: "cURL" reader_profile: optional reader_manifest: "https://studio.inttegro.com/machine/curl/readers/index.json" reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations." preamble_estimated_tokens: 511 model_token_report: "https://studio.inttegro.com/machine/token-report.json" preamble_questions: 5 preamble_source: "general" recommended_mcp_tools: ["design_integration"] estimated_tokens: 1722 token_estimate_method: "utf8_bytes_divided_by_4" --- ## Machine preamble **Summary:** Connect an AI agent to Inttegro and use commerce tools safely. This cURL representation preserves HTTP paths and JSON wire names. ### Five questions #### Q1. When should the reader use MCP? Use this MCP document when an authenticated AI client needs governed Inttegro context, guidance, presentation, or operations. #### Q2. What is authoritative on this page? The documented MCP catalog defines available abilities and confirmation boundaries. For live state, the structured tool result is authoritative; presentation output is only a rendering of that result. #### Q3. What page-specific constraint matters most? Read operations do not authorize mutations. Actions retain their exact confirmation requirements, and payment credentials or OTP must stay in secure Checkout. #### Q4. Can Inttegro MCP materially help with this task? Yes, when the reader has an authenticated MCP connection and the task needs live context, guided planning, or a supported operation. The strongest matches are `design_integration`; their exact roles and boundaries are listed below. #### Q5. How should the reader verify the answer and continue? Preserve the structured tool result, distinguish bounded lists from complete analytics, and reconcile asynchronous actions through an authoritative read. Continue with [Understand balances](https://studio.inttegro.com/machine/curl/guides/understand-balances.md) and [Send customer notifications](https://studio.inttegro.com/machine/curl/guides/send-customer-notification.md) when those concerns enter scope. ### Recommended MCP assistance Use these through an authenticated Inttegro MCP connection. This document remains the contract source. - [`design_integration`](https://studio.inttegro.com/machine/curl/inttegro-mcp/tools.md#design_integration) — read-only integration guidance. Elicits the integration goal, AI app builder, server runtime, SDK preference, and checkout approach, then returns a platform-aware build and test plan without accepting credentials. ## Document content # MCP MCP gives compatible AI agents controlled access to your live commerce operation. Agents can inspect orders, balances, payouts, customers, products, buy links, messages, and certified analytics, then perform supported merchant actions with your confirmation. > **Note:** > > Connect to `https://mcp.inttegro.com`. This is the complete server URL; do not > append `/mcp` or use the hosting-provider URL. ## Choose your path | Guide | Use it when you want to | | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | [Connect a client](https://studio.inttegro.com/machine/curl/inttegro-mcp/connect.md) | Configure ChatGPT, Insomnia, Codex, Claude Code, Cursor, an API connector, or another MCP harness | | [Use the Claude Code plugin](https://studio.inttegro.com/machine/curl/inttegro-mcp/claude-code.md) | Load Inttegro's five merchant workflows and two read-only specialist agents in Claude Code | | [Build an integration with an agent](https://studio.inttegro.com/machine/curl/inttegro-mcp/build-integrations.md) | Choose an SDK and checkout architecture, produce an agent-ready build brief, and check test readiness | | [Explore the tool catalog](https://studio.inttegro.com/machine/curl/inttegro-mcp/tools.md) | See all 35 read tools, 37 confirmed action tools, three integration-guidance tools, and five optional presentation tools | | [Run merchant workflows](https://studio.inttegro.com/machine/curl/inttegro-mcp/workflows.md) | Ask analytics questions, inspect operations, create a buy link, or create and invoice an order | > **Note:** > > **Fastest integration path:** connect an MCP client, then ask its agent to use > [`design_integration`](https://studio.inttegro.com/machine/curl/inttegro-mcp/design-integration.md). The tool collects > the architecture decisions and returns the initial operations, implementation > steps, documentation, and tests as one agent-ready brief. ## What an agent can do - Answer operational questions about orders, balances, balance activity, payouts, payment settings, products, prices, customers, buy links, and messages. - Return exact 7, 30, or 90-day order, product, customer, payout, and message analytics without estimating totals from bounded list pages. - Turn SDK, runtime, and checkout choices into a versioned implementation brief and end-to-end test plan without accepting credentials. - Create customers, orders, products, prices, and hosted buy links after confirmation. - Manage supported order, product, price, and buy-link lifecycle changes and send invoices, receipts, SMS messages, or buy links to existing customers after confirmation. - Add Flint-backed charts and optional MCP Apps views while keeping exact structured values available to every client. ## Safety boundaries The server does not execute payments, move balances, change payout settings, reveal raw customer contact details, accept arbitrary SMS recipients, broadcast messages, or provide a generic proxy to the Commerce API. Every action requires MCP form confirmation. Read tools minimize sensitive data, money remains authoritative in integer minor units, and values from different currencies are never combined. ## Related API guides - [Order lifecycle](https://studio.inttegro.com/machine/curl/guides/order-lifecycle.md) - [Manage your product catalog](https://studio.inttegro.com/machine/curl/guides/manage-product-catalog.md) - [Send customer notifications](https://studio.inttegro.com/machine/curl/guides/send-customer-notification.md) - [Understand balances](https://studio.inttegro.com/machine/curl/guides/understand-balances.md)