Skip to content
MCP server

Iris

AI outreach campaigns that find leads, draft messages and track replies across channels

Status and history

Answered our latest tool-list check 21 hours ago with 81 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
API, Web, CLI
Runs
Locally or Remotely
Version
0.25.3
Listing updated
2 days ago

About Iris

Iris is a freemium MCP server for sales and crm. It can run locally on your machine or as a hosted remote server.

Iris works from a brief: describe who you want to reach and why, and it turns that into target profiles, search criteria and a tone. It then finds matching contacts on Instagram and TikTok, enriches each profile, and drafts a message per contact instead of using templates or mail-merge tokens. You review, edit or set it to auto-send.

Delivery covers email (through SendGrid), Instagram DMs and Twitter DMs, with humanised timing and per-channel formatting. Replies from all three come into one inbox, where Iris drafts the next message for approval. Analytics track opens, replies and conversions.

The free plan allows 2 campaigns a month, 10 contacts per campaign and 80 messages per campaign; paid tiers raise those limits, to 10 campaigns, 60 contacts and 480 messages on Premium. AI agents can instead pay per campaign with x402 or MPP and no account. The MCP server runs over stdio or a hosted endpoint and needs an API key.

Install

Run in a terminal

claude mcp add --transport http iris https://api.iris-ai.dev/mcp

Add to Settings → Connectors → Add custom connector

https://api.iris-ai.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "iris": {
      "url": "https://api.iris-ai.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "iris": {
      "type": "http",
      "url": "https://api.iris-ai.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "iris": {
      "serverUrl": "https://api.iris-ai.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "iris": {
      "type": "http",
      "url": "https://api.iris-ai.dev/mcp"
    }
  }
}

Configuration

  • IRIS_API_KEYYour Iris API key.Required
  • IRIS_API_URLOverride the API host.

Tools this server provides (81)

Read directly from the server.

list_campaigns
list all campaigns with optional filtering by status. requires read scope.
create_campaign
create a new outreach campaign. requires write scope.
get_campaign
get a campaign by ID with stats. requires read scope.
update_campaign
update a campaign's details. requires write scope.
delete_campaign
soft-delete a campaign (sets status to deleted). requires write scope.
list_campaign_contacts
list contacts in a campaign with optional status filter. requires read scope.
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.
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.
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.
rename_campaign_chat
rename a chat session. requires write scope.
delete_campaign_chat
soft-delete a chat session. requires write scope.
get_campaign_usage
get usage limits and current counts for a campaign. requires read scope.
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.
list_target_profiles
list target profiles for a campaign. requires read scope.
create_target_profile
create a target profile for a campaign. requires write scope.
delete_target_profile
delete a target profile from a campaign. requires write scope.
list_contacts
list all contacts with optional search. requires read scope.
create_contact
create a new contact. requires write scope.
get_contact
get a contact by ID. requires read scope.
get_contact_handles
the contact's social handles (instagram/twitter/tiktok) - verify a handle write landed. requires read scope.
update_contact
update a contact's details. requires write scope.
delete_contact
soft-delete a contact. requires write scope.
bulk_import_contacts
import multiple contacts at once, optionally adding them to a campaign. requires write scope.
get_contact_usage
get contact usage limits and current counts for the billing period. requires read scope.
list_contact_conversations
list all conversations for a specific contact. requires read scope.
list_conversations
list conversations with optional filtering. requires read scope.
get_conversation
get a conversation by ID with contact and campaign details. requires read scope.
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.
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.
get_conversation_messages
get all messages in a conversation. requires read scope.
mark_conversation_read
mark a conversation as read. requires write scope.
update_conversation
update a conversation's status: active, archived, or closed. requires write scope.
get_engagement_metrics
get overall engagement metrics across all conversations. requires read scope.
list_pending_messages
list messages awaiting approval before sending. requires read scope.
approve_message
approve a pending message for sending. requires send scope.
reject_message
reject a pending message with an optional reason. requires send scope.
retry_message
retry sending a failed message. requires send scope.
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.
submit_message_feedback
submit feedback on an AI-generated message to improve future generations. requires send scope.
bulk_message_action
approve or reject multiple messages at once. requires send scope.
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_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.
analyze_response
analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires generate scope.
get_ai_usage
get AI generation usage limits and current counts for the billing period. requires read scope.
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.
search_campaign_contacts
search for contacts matching a campaign's target profiles. requires generate scope.
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.
list_discovery_sources
list available discovery data sources and their status. requires read scope.
get_analytics_overview
get a high-level overview of all campaign analytics. requires read scope.
get_campaign_analytics
get detailed analytics for a specific campaign. requires read scope.
get_performance_metrics
get email performance metrics over time. requires read scope.
get_response_time
get average response time analytics. requires read scope.
get_contact_types
get breakdown of contacts by type/source. requires read scope.
get_billing_plans
get all available billing plans with pricing and feature limits. requires read scope.
list_connected_accounts
list all connected social media accounts. requires read scope.
check_channel_availability
check which outreach channels are available and configured. requires read scope.
send_channel_message
send a message through a specific channel in a conversation. requires send scope.
list_notifications
list user notifications. requires read scope.
update_notification
update a notification (e.g., mark as read). requires write scope.
delete_notification
delete a notification. requires write scope.
mark_all_notifications_read
mark all notifications as read. requires write scope.
get_usage
get your current plan, quota usage (campaigns used/remaining this period), and billing period (requires read scope)
get_changelog
machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
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.
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.
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.
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.
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.
list_responder_activity
list the responder's activity log (replies sent, handoffs, skips, and failures), newest first. requires read scope.
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.
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.
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.
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 re
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.
delete_responder_comment_trigger
delete a comment trigger. requires write scope.
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_audiences
list the audience library - reusable target profiles created once and attachable to any campaign. requires read scope.
create_audience
create a library audience profile manually. names are unique per library (case-insensitive). requires write scope.
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.
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.
delete_audience
delete a library audience profile. campaigns it was attached to keep their copy. requires write scope.

What it does

Objective-driven campaigns
Turn a brief into targets and outreach tone.
Lead discovery
Find matching contacts on Instagram and TikTok.
Drafted messages
Personalise each message from the contact's profile.
Three channels
Email, Instagram DM and Twitter DM.
Unified inbox
Replies land in one place with suggested responses.
Review queue
Approve drafts or let them auto-send.
Agent pay-per-campaign
Pay with x402 or MPP, no account.

Good for

  • Book venues by contacting a list of local owners
  • Promote a product to creators on Instagram
  • Follow up on cold email replies from one inbox
  • Run outreach campaigns from an AI agent

Pricing

Freemium

Free plan; paid tiers Starter, Pro and Premium (prices not published)

Prices change. Check iris-ai.dev before you buy.

Iris FAQ

Is there a free plan?

Yes: 2 campaigns a month, 10 contacts and 80 messages per campaign.

Which channels does it use?

Email, Instagram and Twitter.

Does it send without approval?

You can review and edit drafts, or choose to auto-send.

Can agents use it without an account?

Yes, agents can pay per campaign with x402 or MPP.

Is Iris free?

Iris has a free plan, with paid plans for more usage or features.

How do I add Iris to Claude Code?

Run this command in your terminal: claude mcp add --transport http iris https://api.iris-ai.dev/mcp

What are the best alternatives to Iris?

The closest alternatives to Iris are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

Alternatives to Iris

  1. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  2. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  3. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. ZUUZ

    MCP server

    Ask Claude or ChatGPT about deals and follow-ups ZUUZ finds in sales email for MSPs

    Not checked yet
    • Remote
    • Free trial
    • Sales and CRM
  6. Fuse

    MCP server

    Hosted MCP server for B2B prospecting, contact enrichment, buying signals and outreach

    Not checked yet
    • Remote
    • Freemium
    • Sales and CRM