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.
What you can do
Once connected, your AI agent gets almost 50 tools across your account:
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.
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."
⚠️ Uploading and managing media files is done through the REST API, not MCP (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.
For read-only tools like list_contacts or get_scenario, Always allow is convenient. For write actions like send_message or create_campaign, keep Needs approval so you can review before anything goes out.
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.
🐾 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 uses whichever account you're logged into. To switch, log out of Inrō, change organizations, then re-authorize the connector.
In Claude, set frequent read tools like
list_contactsandlist_scenariosto Always allow so you're not approving every lookup.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.