Iris

io.github.JCLVSH/irisVersion 0.25.3

Run multi-channel outreach: campaigns, contacts, conversations, and AI-drafted messages.

Status

Responds238 msNov 14, 2026, 14:38 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:38 UTC
Latency: 238 ms
Remotes responding: 1 of 1
Sign-in: API key
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 21:12 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://api.iris-ai.dev/mcpResponds238 msNov 14, 2026, 14:38 UTC

No sign-in

Claude Code

claude mcp add --transport http iris https://api.iris-ai.dev/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'

Replace <YOUR_TOKEN> before running.

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: iris
Remote MCP server URL: https://api.iris-ai.dev/mcp
This server expects the header Authorization.

Cursor

{
  "mcpServers": {
    "iris": {
      "url": "https://api.iris-ai.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Replace <YOUR_TOKEN> before running.

VS Code

code --add-mcp '{"name":"iris","type":"http","url":"https://api.iris-ai.dev/mcp","headers":{"Authorization":"Bearer <YOUR_TOKEN>"}}'

Replace <YOUR_TOKEN> before running.

Streamable HTTP

npm: @jclvsh/iris 0.25.3

Package only

npm (npx)

claude mcp add iris -e 'IRIS_API_KEY=<YOUR_IRIS_API_KEY>' -- npx -y @jclvsh/iris@0.25.3

Replace <YOUR_IRIS_API_KEY> before running.

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

81 tools

Tools of Iris
	Description		Read-only	Idempotent	Open world
`add_campaign_contacts`add contacts to a campaign, by id or by creating them inline. a campaign needs at least one contact before it can be activated. requires write scope.	add contacts to a campaign, by id or by creating them inline. a campaign needs at least one contact before it can be activated. requires write scope.	No	No	Not declared	Not declared
`analyze_campaign`queue AI analysis of a campaign to generate its target profiles: from the product for product_promotion campaigns, from goal_description for any other campaign. runs asynchronously; poll get_campaign until analysis_status is completed, then search_campaign_contacts. requires write scope.	queue AI analysis of a campaign to generate its target profiles: from the product for product_promotion campaigns, from goal_description for any other campaign. runs asynchronously; poll get_campaign until analysis_status is completed, then search_campaign_contacts. requires write scope.	No	No	Not declared	Not declared
`analyze_response`analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires generate scope.	analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires generate scope.	No	No	Not declared	Not declared
`approve_message`approve a pending message for sending. requires send scope.	approve a pending message for sending. requires send scope.	Yes	No	Not declared	Not declared
`attach_audience_to_campaign`copy a library audience into a campaign. the response is the campaign's own copy (a target profile) - editing it never touches the library master. if the campaign already has a same-named profile, the existing copy is returned. requires write scope.	copy a library audience into a campaign. the response is the campaign's own copy (a target profile) - editing it never touches the library master. if the campaign already has a same-named profile, the existing copy is returned. requires write scope.	No	No	Not declared	Not declared
`bulk_import_contacts`import multiple contacts at once, optionally adding them to a campaign. requires write scope.	import multiple contacts at once, optionally adding them to a campaign. requires write scope.	No	No	Not declared	Not declared
`bulk_message_action`approve or reject multiple messages at once. requires send scope.	approve or reject multiple messages at once. requires send scope.	Yes	No	Not declared	Not declared
`check_channel_availability`check which outreach channels are available and configured. requires read scope.	check which outreach channels are available and configured. requires read scope.	No	Yes	Not declared	Not declared
`configure_autopilot`create or update the autopilot config (merge: only the fields you send change; first call creates the config with defaults). autopilot is review-only - drafts wait in the approval queue, nothing sends without approval. requires write scope.	create or update the autopilot config (merge: only the fields you send change; first call creates the config with defaults). autopilot is review-only - drafts wait in the approval queue, nothing sends without approval. requires write scope.	No	No	Not declared	Not declared
`configure_responder`create or update the responder config (merge: only the fields you send change; the first call creates the config). with auto_reply on, replies are sent without review. Instagram only allows a reply within 24 hours of the person's last message, and only to someone who wrote first. requires write scope.	create or update the responder config (merge: only the fields you send change; the first call creates the config). with auto_reply on, replies are sent without review. Instagram only allows a reply within 24 hours of the person's last message, and only to someone who wrote first. requires write scope.	Yes	No	Not declared	Not declared
`create_audience`create a library audience profile manually. names are unique per library (case-insensitive). requires write scope.	create a library audience profile manually. names are unique per library (case-insensitive). requires write scope.	No	No	Not declared	Not declared
`create_campaign`create a new outreach campaign. requires write scope.	create a new outreach campaign. requires write scope.	No	No	Not declared	Not declared
`create_contact`create a new contact. requires write scope.	create a new contact. requires write scope.	No	No	Not declared	Not declared
`create_conversation`find-or-create a conversation for a contact - the hub conversation by default, or the campaign-scoped thread when campaign_id is passed (contact must be in that campaign). requires write scope.	find-or-create a conversation for a contact - the hub conversation by default, or the campaign-scoped thread when campaign_id is passed (contact must be in that campaign). requires write scope.	No	No	Not declared	Not declared
`create_conversation_message`create a message in a conversation. status pending_approval places it in the human review queue instead of sending. requires write scope.	create a message in a conversation. status pending_approval places it in the human review queue instead of sending. requires write scope.	Yes	No	Not declared	Not declared
`create_responder_comment_trigger`create a comment trigger. when someone comments the keyword on the account's instagram post, iris sends that person one direct message: the owner's message as written, followed by the notice that it is automated. instagram allows one such message per comment, within 7 days of the comment, and nothing more unless the person replies. it only sends while status.comment_triggers on get_responder is ready; needs_permission means the owner has to reconnect instagram from the responder settings page in the iris web app, unavailable means the feature isn't offered on the account yet. each message sent counts as a message against the plan. needs an API key and a connected instagram account; x402 and MPP identities cannot use it. at most 20 triggers per account, and a second trigger with the same keyword on the same post is refused. requires write scope.	create a comment trigger. when someone comments the keyword on the account's instagram post, iris sends that person one direct message: the owner's message as written, followed by the notice that it is automated. instagram allows one such message per comment, within 7 days of the comment, and nothing more unless the person replies. it only sends while status.comment_triggers on get_responder is ready; needs_permission means the owner has to reconnect instagram from the responder settings page in the iris web app, unavailable means the feature isn't offered on the account yet. each message sent counts as a message against the plan. needs an API key and a connected instagram account; x402 and MPP identities cannot use it. at most 20 triggers per account, and a second trigger with the same keyword on the same post is refused. requires write scope.	Yes	No	Not declared	Not declared
`create_target_profile`create a target profile for a campaign. requires write scope.	create a target profile for a campaign. requires write scope.	No	No	Not declared	Not declared
`delete_audience`delete a library audience profile. campaigns it was attached to keep their copy. requires write scope.	delete a library audience profile. campaigns it was attached to keep their copy. requires write scope.	Yes	No	Not declared	Not declared
`delete_campaign`soft-delete a campaign (sets status to deleted). requires write scope.	soft-delete a campaign (sets status to deleted). requires write scope.	Yes	No	Not declared	Not declared
`delete_campaign_chat`soft-delete a chat session. requires write scope.	soft-delete a chat session. requires write scope.	Yes	No	Not declared	Not declared
`delete_contact`soft-delete a contact. requires write scope.	soft-delete a contact. requires write scope.	Yes	No	Not declared	Not declared
`delete_notification`delete a notification. requires write scope.	delete a notification. requires write scope.	Yes	No	Not declared	Not declared
`delete_responder_comment_trigger`delete a comment trigger. requires write scope.	delete a comment trigger. requires write scope.	Yes	No	Not declared	Not declared
`delete_target_profile`delete a target profile from a campaign. requires write scope.	delete a target profile from a campaign. requires write scope.	Yes	No	Not declared	Not declared
`generate_audiences`AI-generate audience profiles from a product (scrape + analysis) into the library. generated names already in the library are skipped, not overwritten. rate limited to 5 per hour. requires generate scope.	AI-generate audience profiles from a product (scrape + analysis) into the library. generated names already in the library are skipped, not overwritten. rate limited to 5 per hour. requires generate scope.	No	No	Not declared	Not declared
`generate_campaign_content`generate campaign-level outreach content (email sequence, templates) from a campaign brief. content-first: takes the strategy inline, not a campaign id. requires generate scope.	generate campaign-level outreach content (email sequence, templates) from a campaign brief. content-first: takes the strategy inline, not a campaign id. requires generate scope.	No	No	Not declared	Not declared
`generate_content`generate AI outreach content (email or DM draft) for a contact/campaign. the contact's tags + enrichment_data feed the generation context automatically. requires generate scope.	generate AI outreach content (email or DM draft) for a contact/campaign. the contact's tags + enrichment_data feed the generation context automatically. requires generate scope.	No	No	Not declared	Not declared
`get_ai_usage`get AI generation usage limits and current counts for the billing period. requires read scope.	get AI generation usage limits and current counts for the billing period. requires read scope.	No	Yes	Not declared	Not declared
`get_analytics_overview`get a high-level overview of all campaign analytics. requires read scope.	get a high-level overview of all campaign analytics. requires read scope.	No	Yes	Not declared	Not declared
`get_autopilot_status`get autopilot status: whether it's configured, the current config, the pending-review count for the standing campaign, and the latest run's step results. requires read scope.	get autopilot status: whether it's configured, the current config, the pending-review count for the standing campaign, and the latest run's step results. requires read scope.	No	Yes	Not declared	Not declared
`get_billing_plans`get all available billing plans with pricing and feature limits. requires read scope.	get all available billing plans with pricing and feature limits. requires read scope.	No	Yes	Not declared	Not declared
`get_campaign`get a campaign by ID with stats. requires read scope.	get a campaign by ID with stats. requires read scope.	No	Yes	Not declared	Not declared
`get_campaign_analytics`get detailed analytics for a specific campaign. requires read scope.	get detailed analytics for a specific campaign. requires read scope.	No	Yes	Not declared	Not declared
`get_campaign_chat_messages`list the messages in a chat session, oldest first. `content` is an array of opaque blocks (text / tool_use / tool_result). requires read scope.	list the messages in a chat session, oldest first. `content` is an array of opaque blocks (text / tool_use / tool_result). requires read scope.	No	Yes	Not declared	Not declared
`get_campaign_usage`get usage limits and current counts for a campaign. requires read scope.	get usage limits and current counts for a campaign. requires read scope.	No	Yes	Not declared	Not declared
`get_changelog`machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.	machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.	No	Yes	Not declared	Not declared
`get_contact`get a contact by ID. requires read scope.	get a contact by ID. requires read scope.	No	Yes	Not declared	Not declared
`get_contact_handles`the contact's social handles (instagram/twitter/tiktok) - verify a handle write landed. requires read scope.	the contact's social handles (instagram/twitter/tiktok) - verify a handle write landed. requires read scope.	No	Yes	Not declared	Not declared
`get_contact_types`get breakdown of contacts by type/source. requires read scope.	get breakdown of contacts by type/source. requires read scope.	No	Yes	Not declared	Not declared
`get_contact_usage`get contact usage limits and current counts for the billing period. requires read scope.	get contact usage limits and current counts for the billing period. requires read scope.	No	Yes	Not declared	Not declared
`get_conversation`get a conversation by ID with contact and campaign details. requires read scope.	get a conversation by ID with contact and campaign details. requires read scope.	No	Yes	Not declared	Not declared
`get_conversation_messages`get all messages in a conversation. requires read scope.	get all messages in a conversation. requires read scope.	No	Yes	Not declared	Not declared
`get_conversation_responder`get the responder's status for a single conversation: active, paused, handed off, or never seen, plus the reason and reply counts. requires read scope.	get the responder's status for a single conversation: active, paused, handed off, or never seen, plus the reason and reply counts. requires read scope.	No	Yes	Not declared	Not declared
`get_discovery_job`get the status, progress, and contacts of a discovery job. status values: pending, running, completed, failed. contacts populated only when status=completed. requires read scope.	get the status, progress, and contacts of a discovery job. status values: pending, running, completed, failed. contacts populated only when status=completed. requires read scope.	No	Yes	Not declared	Not declared
`get_engagement_metrics`get overall engagement metrics across all conversations. requires read scope.	get overall engagement metrics across all conversations. requires read scope.	No	Yes	Not declared	Not declared
`get_performance_metrics`get email performance metrics over time. requires read scope.	get email performance metrics over time. requires read scope.	No	Yes	Not declared	Not declared
`get_responder`get responder status: whether it's configured, the current config, connection and pause status, and activity counts for the last 30 days. requires read scope.	get responder status: whether it's configured, the current config, connection and pause status, and activity counts for the last 30 days. requires read scope.	No	Yes	Not declared	Not declared
`get_response_time`get average response time analytics. requires read scope.	get average response time analytics. requires read scope.	No	Yes	Not declared	Not declared
`get_usage`get your current plan, quota usage (campaigns used/remaining this period), and billing period (requires read scope)	get your current plan, quota usage (campaigns used/remaining this period), and billing period (requires read scope)	No	Yes	Not declared	Not declared
`list_audiences`list the audience library - reusable target profiles created once and attachable to any campaign. requires read scope.	list the audience library - reusable target profiles created once and attachable to any campaign. requires read scope.	No	Yes	Not declared	Not declared
`list_campaign_chats`list your iris chat sessions (the conversational campaign builder), most recently updated first, max 100. the live chat turn itself is a server-sent-events stream outside this tool set. requires read scope.	list your iris chat sessions (the conversational campaign builder), most recently updated first, max 100. the live chat turn itself is a server-sent-events stream outside this tool set. requires read scope.	No	Yes	Not declared	Not declared
`list_campaign_contacts`list contacts in a campaign with optional status filter. requires read scope.	list contacts in a campaign with optional status filter. requires read scope.	No	Yes	Not declared	Not declared
`list_campaigns`list all campaigns with optional filtering by status. requires read scope.	list all campaigns with optional filtering by status. requires read scope.	No	Yes	Not declared	Not declared
`list_connected_accounts`list all connected social media accounts. requires read scope.	list all connected social media accounts. requires read scope.	No	Yes	Not declared	Not declared
`list_contact_conversations`list all conversations for a specific contact. requires read scope.	list all conversations for a specific contact. requires read scope.	No	Yes	Not declared	Not declared
`list_contacts`list all contacts with optional search. requires read scope.	list all contacts with optional search. requires read scope.	No	Yes	Not declared	Not declared
`list_conversations`list conversations with optional filtering. requires read scope.	list conversations with optional filtering. requires read scope.	No	Yes	Not declared	Not declared
`list_discovery_sources`list available discovery data sources and their status. requires read scope.	list available discovery data sources and their status. requires read scope.	No	Yes	Not declared	Not declared
`list_notifications`list user notifications. requires read scope.	list user notifications. requires read scope.	No	Yes	Not declared	Not declared
`list_pending_messages`list messages awaiting approval before sending. requires read scope.	list messages awaiting approval before sending. requires read scope.	No	Yes	Not declared	Not declared
`list_responder_activity`list the responder's activity log (replies sent, handoffs, skips, and failures), newest first. requires read scope.	list the responder's activity log (replies sent, handoffs, skips, and failures), newest first. requires read scope.	No	Yes	Not declared	Not declared
`list_responder_comment_triggers`list the account's comment triggers. a comment trigger watches for a keyword in instagram comments and sends the commenter one automatic DM. requires read scope.	list the account's comment triggers. a comment trigger watches for a keyword in instagram comments and sends the commenter one automatic DM. requires read scope.	No	Yes	Not declared	Not declared
`list_responder_posts`list the account's recent instagram posts with their media ids, for limiting a comment trigger to one post. requires read scope.	list the account's recent instagram posts with their media ids, for limiting a comment trigger to one post. requires read scope.	No	Yes	Not declared	Not declared
`list_target_profiles`list target profiles for a campaign. requires read scope.	list target profiles for a campaign. requires read scope.	No	Yes	Not declared	Not declared
`mark_all_notifications_read`mark all notifications as read. requires write scope.	mark all notifications as read. requires write scope.	No	No	Not declared	Not declared
`mark_conversation_read`mark a conversation as read. requires write scope.	mark a conversation as read. requires write scope.	No	No	Not declared	Not declared
`mark_message_sent`mark a pending manual-channel draft (tiktok, or instagram cold first-touch) as sent outside the platform. API-sendable drafts must use approve_message instead. requires write scope.	mark a pending manual-channel draft (tiktok, or instagram cold first-touch) as sent outside the platform. API-sendable drafts must use approve_message instead. requires write scope.	No	No	Not declared	Not declared
`reject_message`reject a pending message with an optional reason. requires send scope.	reject a pending message with an optional reason. requires send scope.	Yes	No	Not declared	Not declared
`rename_campaign_chat`rename a chat session. requires write scope.	rename a chat session. requires write scope.	No	No	Not declared	Not declared
`retry_message`retry sending a failed message. requires send scope.	retry sending a failed message. requires send scope.	Yes	No	Not declared	Not declared
`run_autopilot_now`queue a manual autopilot run immediately (insights refresh + discovery top-up on the standing campaign). steps that already completed today are skipped. rate limited to 2 per hour. requires generate scope.	queue a manual autopilot run immediately (insights refresh + discovery top-up on the standing campaign). steps that already completed today are skipped. rate limited to 2 per hour. requires generate scope.	No	No	Not declared	Not declared
`search_campaign_contacts`search for contacts matching a campaign's target profiles. requires generate scope.	search for contacts matching a campaign's target profiles. requires generate scope.	No	No	Not declared	Not declared
`search_contacts`kick off a multi-source contact discovery job (Apify-backed). returns a job_id and contacts when ready (waits up to 90s; if status=queued, poll get_discovery_job). closed source list: google_maps, instagram, twitter, tiktok, reddit. requires generate scope.	kick off a multi-source contact discovery job (Apify-backed). returns a job_id and contacts when ready (waits up to 90s; if status=queued, poll get_discovery_job). closed source list: google_maps, instagram, twitter, tiktok, reddit. requires generate scope.	No	No	Not declared	Not declared
`send_channel_message`send a message through a specific channel in a conversation. requires send scope.	send a message through a specific channel in a conversation. requires send scope.	Yes	No	Not declared	Not declared
`set_conversation_responder`pause or resume the responder for a single conversation. pausing works on any conversation; resuming is refused after the person asked iris to stop. requires write scope.	pause or resume the responder for a single conversation. pausing works on any conversation; resuming is refused after the person asked iris to stop. requires write scope.	Yes	No	Not declared	Not declared
`submit_message_feedback`submit feedback on an AI-generated message to improve future generations. requires send scope.	submit feedback on an AI-generated message to improve future generations. requires send scope.	No	No	Not declared	Not declared
`update_campaign`update a campaign's details. requires write scope.	update a campaign's details. requires write scope.	No	No	Not declared	Not declared
`update_contact`update a contact's details. requires write scope.	update a contact's details. requires write scope.	No	No	Not declared	Not declared
`update_conversation`update a conversation's status: active, archived, or closed. requires write scope.	update a conversation's status: active, archived, or closed. requires write scope.	No	No	Not declared	Not declared
`update_notification`update a notification (e.g., mark as read). requires write scope.	update a notification (e.g., mark as read). requires write scope.	No	No	Not declared	Not declared
`update_responder_comment_trigger`update a comment trigger's keyword, message, media_id, or enabled state. give at least one field besides id. someone else's trigger, or an id that isn't a comment trigger on this account, is a 404. requires write scope.	update a comment trigger's keyword, message, media_id, or enabled state. give at least one field besides id. someone else's trigger, or an id that isn't a comment trigger on this account, is a 404. requires write scope.	Yes	No	Not declared	Not declared

Details

Registry status: Active
Published: Nov 13, 2026
Updated: Nov 13, 2026
Website: https://www.iris-ai.dev/⁠ (opens in a new tab)
Repository: Not given
Categories (suggested): Communication Marketing and SEOSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing