You can control your Inrō account from an AI agent like Claude or ChatGPT. Instead of switching between tabs, you ask your agent in plain language to look up contacts, send messages, build scenarios, launch campaigns, and more, all in one conversation.
This works through the MCP Server. MCP (Model Context Protocol) is a standard that connects AI tools to outside apps. Think of it as giving your AI agent a set of keys to your Inrō account so it can take actions for you.
Before you start
The MCP Server needs a Pro or Trial subscription, the same as the Private API. Everything your agent does is scoped to the one Inrō organization you connect. If you run several Instagram accounts, you can add the MCP Server once per account. See Connect Multiple Instagram Accounts to Claude or ChatGPT.
What you can do
Once connected, your AI agent gets 23 tools, one per resource (contacts, scenarios, campaigns, and so on). Each tool takes an action such as list, get, create or update, which keeps tool selection reliable. Together they cover:
Publishing: Upload media files, then create, schedule, publish or delete Instagram posts (image, reel or carousel) and stories.
Conversion links: Create, update and delete the tracked link cards you send in messages and flows.
Scenario and campaign folders: Create folders, move automations into them, duplicate a folder, reorder priority folders, and switch a whole folder on or off.
Reference tools: Look up every action type, trigger type and contact filter type, which your agent uses to build scenarios, campaigns and contact segments correctly.
Comment-to-DM in one call: Attach a Comment-to-DM automation to any post through the media tool.
Contacts: Search, view, and update contacts. Add or remove them from folders. Update contacts in bulk (up to 1,000 at once) with progress tracking.
Contact properties: List, create, update, and delete custom contact properties.
Messages: Send text, image, video, audio, and media-post messages to your contacts.
Scenarios: List, view, create, update, and trigger scenarios.
Campaigns: Create, update, send, and view campaign performance.
Batch tasks: Track long-running jobs like bulk contact updates and campaign sends.
Folders: Create, update, delete, and list folders. View the contacts inside a folder.
Media posts: Browse your Instagram posts and share them with contacts.
Templates: Search the scenario and campaign template library.
AI Agent configuration: View and update agent settings, manage knowledge base items, set up intent-triggered actions, and choose which contact properties to track.
Product knowledge: Look up how Inrō features work.
Account: View your organization info.
DM entry points and opt-out: Read and update your ice breakers, your Instagram persistent menu, and your opt-out keywords and messages. Ice breakers and the menu are read back from Instagram on every call, so your agent sees what Instagram is currently showing.
Type reference: Look up every action type and trigger type, which your agent uses to build and edit scenarios and campaigns correctly.
You can combine these in one conversation. For example: "Find all contacts in my 'VIP' folder who haven't been messaged in 30 days, then create a re-engagement campaign for them."
Your agent can also upload and manage media files with the media files tool: give it a public URL and Inrō downloads the file, or ask for an upload link for a file that only exists on your computer. See Manage Media Files via the API. You can still attach media to a scenario action by giving your agent an image, video, or audio URL.
Edit your scenarios with your AI agent
When you open a scenario that was generated from a prompt, or if you already have Claude or ChatGPT connected, you'll see an Edit with your AI agent card right in the scenario editor.
Clicking it opens the MCP setup so you can connect your agent and start editing that scenario through conversation. You can dismiss the card once you no longer need it.
Where to find your MCP Server URL
Open the account menu (bottom-left) and go to Integrations & API.
Find the MCP Server card and click Copy next to the URL.
Your MCP Server URL is:
https://api.inro.social/mcp
You'll need this URL for both the Claude and ChatGPT setup below.
How to connect with Claude
Claude supports MCP through custom connectors.
1. Open Claude's connector settings
Go to claude.ai. Click your profile icon in the bottom-left, then go to Settings -> Connectors. Click Add custom connector.
2. Add the Inrō connector
Paste the MCP Server URL (https://api.inro.social/mcp) into the URL field. Give it a name like "Inrō" and click Add.
3. Connect and authorize
Click Connect next to the Inrō connector. You'll be sent to an Inrō authorization screen that shows which account will be connected and the permissions being requested. Review the account, then click Authorize.
4. Set tool permissions
Back in Claude, open the Inrō connector to see the full list of available tools. Each tool has three options:
Always allow: the tool runs without asking first.
Needs approval: Claude asks you to confirm before using it (this is the default).
Never allow: the tool is blocked.
Because one tool covers both reading and writing a resource (for example, contacts can list contacts and also update them), Always allow on a tool lets your agent write to it without asking. Keep Needs approval on contacts, scenarios, campaigns, medias, stories and send_message so you can review before anything goes out, and on icebreakers, persistent_menu and settings, which change what people see on your Instagram profile and in your DMs. Read-only tools you can safely set to Always allow are get_organization_info, get_action_types, get_trigger_types, get_contact_filter_types, search_templates, search_product_knowledge and batch_tasks.
5. Start using it
Open a new chat in Claude and try something like:
"Show me my most recent contacts in Inrō"
"List all my active scenarios"
"Create a new folder called 'March Leads'"
"Create a contact property called 'Subscription Plan' with options Free, Pro, and Business"
"Add a knowledge item to my AI agent about our return policy"
"Create an action: when someone wants to buy, add them to my 'Hot Leads' folder"
"Update all contacts in my 'Cold Leads' folder: mark them as opted out"
Claude calls the right Inrō tool and shows you the result in the conversation.
How to connect with ChatGPT
ChatGPT supports MCP servers through its Developer Mode, which is in beta. Setup takes a few more steps than Claude, and the feature is available on ChatGPT Plus, Business, Enterprise, and Edu plans.
1. Turn on Developer Mode
Go to chatgpt.com. Click your profile icon, then go to Settings -> Apps. Scroll to Advanced settings and turn on Developer Mode.
2. Create a new app
With Developer Mode on, click Create app next to Advanced settings. Fill in the form:
Name:
InrōDescription:
Inrō Automation(or any short description)MCP Server URL:
https://api.inro.social/mcpAuthentication: choose OAuth
3. Review advanced settings
Click Advanced settings inside the app form to expand the OAuth configuration. ChatGPT discovers Inrō's OAuth endpoints automatically, so these fields fill in for you:
Auth URL:
https://api.inro.social/oauth/authorizeToken URL:
https://api.inro.social/oauth/tokenRegistration URL:
https://api.inro.social/oauth/registerRegistration method: Dynamic Client Registration (DCR)
You don't need to change any of these. Make sure the Default scopes checkbox for all is selected. Check I understand and want to continue to acknowledge the custom-server warning, then click Create.
4. Connect the app
Find the Inrō app in your Apps list. Click Connect, then Continue to Inrō in the popup. You'll land on the same Inrō authorization screen Claude uses. Click Authorize.
5. Use it in a conversation
Start a new chat in ChatGPT. Click the + menu in the composer, choose Developer Mode, then select the Inrō app. Now you can ask ChatGPT to work with your Inrō account.
⚠️ ChatGPT's MCP support is in beta, so you may hit occasional connection issues. If the OAuth step errors, disconnect and reconnect the app from Settings -> Apps.
Claude vs. ChatGPT
Claude | ChatGPT | |
Setup method | Custom connector | Developer Mode app |
Authentication | OAuth (auto) | OAuth (auto via DCR) |
Approval | Per-tool permission controls | Confirms before write actions |
Status | Stable | Beta |
Plan required | Claude Pro or higher | ChatGPT Plus, Business, Enterprise, or Edu |
Both connect to the same Inrō MCP Server and get the same set of tools.
See what your agent did
Every MCP tool call is recorded with its parameters and Inrō's response, and kept for 30 days. To review them, open your profile menu and go to View platform logs (a Pro feature), then the API & MCP tab. It's the quickest way to check what a tool actually changed when a result looks off.
🐾 Netsuke's Tips
Start with read-only requests ("list my folders", "show me this contact") before write actions. It's a good way to learn what's available and how the tools respond.
If you manage several Inrō organizations, the connection links to whichever account you're logged into when you authorize. To work with more than one, add a separate connector per account instead of re-authorizing back and forth. See Connect Multiple Instagram Accounts to Claude or ChatGPT.
In Claude, set the reference tools (
get_action_types,get_trigger_types,get_contact_filter_types,search_templates) to Always allow so you're not approving every lookup. Leave the resource tools on Needs approval, since the same tool can also write.The MCP Server gives your agent real write access to your account. There's no sandbox. Always review write actions (sending messages, creating campaigns, deleting properties) before confirming.
What's next?
Configure Your AI Agent via API & MCP to manage your agent's knowledge, actions, and settings through Claude or ChatGPT.
The Inrō Private API: Getting Started for the code-first path and the full API reference.
Integrations Overview: What Connects to Inrō for the bigger picture on how Inrō connects to your other tools.