Iris
Run multi-channel outreach: campaigns, contacts, conversations, and AI-drafted messages.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (4)
- LOWin list_responder_comment_triggers
- LOWin create_responder_comment_trigger
- LOWin update_responder_comment_trigger
- LOWin delete_responder_comment_trigger
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"iris": {
"url": "https://api.iris-ai.dev/mcp"
}
}
}Remote-Endpunkte
https://api.iris-ai.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (81)
🟢list_campaigns(page, page_size, status)
list all campaigns with optional filtering by status. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
},
"status": {
"type": "string",
"enum": [
"draft",
"active",
"paused",
"completed",
"deleted"
],
"description": "filter by campaign status"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_campaign(name, objective_type, product_name, product_url, product_description)
create a new outreach campaign. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "campaign name"
},
"objective_type": {
"type": "string",
"enum": [
"venue_dj",
"venue_host",
"product_promotion",
"custom"
],
"description": "campaign objective type"
},
"product_name": {
"type": "string",
"maxLength": 200,
"description": "product name (for product_promotion objective)"
},
"product_url": {
"type": "string",
"format": "uri",
"description": "product URL (for product_promotion objective)"
},
"product_description": {
"type": "string",
"maxLength": 2000,
"description": "product description (for product_promotion objective)"
}
},
"required": [
"name",
"objective_type"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_campaign(id)
get a campaign by ID with stats. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_campaign(id, name, status, follow_up_enabled, follow_up_max_count, ...)
update a campaign's details. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "new campaign name"
},
"status": {
"type": "string",
"enum": [
"draft",
"active",
"paused",
"completed",
"deleted"
],
"description": "new campaign status"
},
"follow_up_enabled": {
"type": "boolean",
"description": "enable follow-up emails"
},
"follow_up_max_count": {
"type": "integer",
"minimum": 0,
"maximum": 10,
"description": "max follow-up count"
},
"follow_up_delay_days": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "days between follow-ups"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_campaign(id)
soft-delete a campaign (sets status to deleted). requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_campaign_contacts(id, page, page_size, status)
list contacts in a campaign with optional status filter. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
},
"status": {
"type": "string",
"enum": [
"pending",
"queued",
"contacted",
"responded",
"converted",
"bounced",
"opted_out"
],
"description": "filter by contact status"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_campaign_contacts(id, contact_ids, contacts, deduplicate)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"contact_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"description": "ids of existing contacts to link"
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "new contacts to create and link (same shape as create_contact)"
},
"deduplicate": {
"type": "boolean",
"description": "skip contacts already linked (default true)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_campaign_chat_messages(chat_id)
list the messages in a chat session, oldest first. `content` is an array of opaque blocks (text / tool_use / tool_result). requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"chat_id": {
"type": "string",
"format": "uuid",
"description": "chat session ID"
}
},
"required": [
"chat_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡rename_campaign_chat(chat_id, title)
rename a chat session. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"chat_id": {
"type": "string",
"format": "uuid",
"description": "chat session ID"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "new title"
}
},
"required": [
"chat_id",
"title"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_campaign_chat(chat_id)
soft-delete a chat session. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"chat_id": {
"type": "string",
"format": "uuid",
"description": "chat session ID"
}
},
"required": [
"chat_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_campaign_usage(id)
get usage limits and current counts for a campaign. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡analyze_campaign(id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_target_profiles(id)
list target profiles for a campaign. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_target_profile(id, name, profile_type, job_titles, industries, ...)
create a target profile for a campaign. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "profile name"
},
"profile_type": {
"type": "string",
"enum": [
"local_business",
"content_creator",
"influencer",
"b2b_professional",
"ecommerce",
"saas_company",
"agency",
"freelancer",
"other"
],
"description": "type of target profile"
},
"job_titles": {
"type": "array",
"items": {
"type": "string"
},
"description": "target job titles"
},
"industries": {
"type": "array",
"items": {
"type": "string"
},
"description": "target industries"
},
"discovery_keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "keywords for contact discovery"
},
"recommended_channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"email",
"instagram",
"twitter"
]
},
"description": "recommended outreach channels"
}
},
"required": [
"id",
"name",
"profile_type"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_target_profile(id, profile_id)
delete a target profile from a campaign. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"profile_id": {
"type": "string",
"format": "uuid",
"description": "target profile ID"
}
},
"required": [
"id",
"profile_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_contacts(page, page_size, search)
list all contacts with optional search. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
},
"search": {
"type": "string",
"description": "search by name, email, or company"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_contact(email, first_name, last_name, company_name, job_title, ...)
create a new contact. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "contact email address"
},
"first_name": {
"type": "string",
"maxLength": 100,
"description": "first name"
},
"last_name": {
"type": "string",
"maxLength": 100,
"description": "last name"
},
"company_name": {
"type": "string",
"maxLength": 200,
"description": "company name"
},
"job_title": {
"type": "string",
"maxLength": 200,
"description": "job title"
},
"phone": {
"type": "string",
"maxLength": 50,
"description": "phone number"
},
"website": {
"type": "string",
"format": "uri",
"description": "website URL"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "tags for categorization"
}
},
"required": [
"email"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_contact(id)
get a contact by ID. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "contact ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_contact_handles(id)
the contact's social handles (instagram/twitter/tiktok) - verify a handle write landed. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "contact ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_contact(id, email, first_name, last_name, company_name, ...)
update a contact's details. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "contact ID"
},
"email": {
"type": "string",
"format": "email",
"description": "email address"
},
"first_name": {
"type": "string",
"maxLength": 100,
"description": "first name"
},
"last_name": {
"type": "string",
"maxLength": 100,
"description": "last name"
},
"company_name": {
"type": "string",
"maxLength": 200,
"description": "company name"
},
"job_title": {
"type": "string",
"maxLength": 200,
"description": "job title"
},
"phone": {
"type": "string",
"maxLength": 50,
"description": "phone number"
},
"website": {
"type": "string",
"format": "uri",
"description": "website URL"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "tags for categorization"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_contact(id)
soft-delete a contact. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "contact ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡bulk_import_contacts(contacts, campaign_id)
import multiple contacts at once, optionally adding them to a campaign. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "contact email"
},
"first_name": {
"type": "string",
"description": "first name"
},
"last_name": {
"type": "string",
"description": "last name"
},
"company_name": {
"type": "string",
"description": "company name"
},
"job_title": {
"type": "string",
"description": "job title"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "tags"
}
},
"required": [
"email"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 500,
"description": "array of contacts to import"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "campaign ID to add contacts to"
}
},
"required": [
"contacts"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_contact_usage
get contact usage limits and current counts for the billing period. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_contact_conversations(id)
list all conversations for a specific contact. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "contact ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_conversations(page, page_size, status, campaign_id)
list conversations with optional filtering. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
},
"status": {
"type": "string",
"enum": [
"active",
"completed",
"failed",
"human_review"
],
"description": "filter by conversation status"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "filter by campaign ID"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_conversation(id)
get a conversation by ID with contact and campaign details. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_conversation(contact_id, campaign_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"format": "uuid",
"description": "contact ID to converse with"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "scope to a campaign the contact belongs to"
}
},
"required": [
"contact_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴create_conversation_message(id, content, direction, status, channel, ...)
create a message in a conversation. status pending_approval places it in the human review queue instead of sending. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
},
"content": {
"type": "string",
"minLength": 1,
"description": "message content"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
],
"description": "message direction"
},
"status": {
"type": "string",
"enum": [
"draft",
"queued",
"sending",
"pending_approval",
"sent",
"delivered",
"failed",
"bounced",
"rejected"
],
"description": "initial message status"
},
"channel": {
"type": "string",
"enum": [
"email",
"twitter",
"instagram",
"tiktok"
],
"description": "delivery channel (tiktok is manual-send: record only)"
},
"platform_recipient_id": {
"type": "string",
"description": "platform recipient id (twitter/instagram channels)"
}
},
"required": [
"id",
"content",
"direction",
"status",
"channel"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_conversation_messages(id)
get all messages in a conversation. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡mark_conversation_read(id)
mark a conversation as read. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_conversation(id, status)
update a conversation's status: active, archived, or closed. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
},
"status": {
"type": "string",
"enum": [
"active",
"archived",
"closed"
],
"description": "new conversation status"
}
},
"required": [
"id",
"status"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_engagement_metrics
get overall engagement metrics across all conversations. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_pending_messages(page, page_size, campaign_id)
list messages awaiting approval before sending. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "filter by campaign ID"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴approve_message(id)
approve a pending message for sending. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "message ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reject_message(id, reason)
reject a pending message with an optional reason. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "message ID"
},
"reason": {
"type": "string",
"maxLength": 500,
"description": "reason for rejection"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴retry_message(id)
retry sending a failed message. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "message ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡mark_message_sent(id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "approval queue item ID, or the message ID for drafts created via create_message (they have no approval item)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡submit_message_feedback(id, feedback)
submit feedback on an AI-generated message to improve future generations. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "message ID"
},
"feedback": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "feedback text"
}
},
"required": [
"id",
"feedback"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴bulk_message_action(action, message_ids)
approve or reject multiple messages at once. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"approve",
"reject"
],
"description": "action to perform"
},
"message_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 1,
"maxItems": 100,
"description": "message IDs to act on"
}
},
"required": [
"action",
"message_ids"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪generate_content(generation_type, tone, campaign_id, contact_id, prompt, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"generation_type": {
"type": "string",
"enum": [
"initial_outreach",
"follow_up",
"response_negotiation",
"meeting_request",
"closing"
],
"description": "type of content to generate"
},
"tone": {
"type": "string",
"minLength": 1,
"description": "tone (e.g. professional, friendly, casual, formal, persuasive, informative)"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "campaign to scope the generation to"
},
"contact_id": {
"type": "string",
"format": "uuid",
"description": "target contact - its tags + enrichment_data are used automatically"
},
"prompt": {
"type": "string",
"description": "additional freeform instructions"
},
"format": {
"type": "string",
"enum": [
"email",
"dm"
],
"description": "dm = short platform-native message text with empty subject. defaults to email"
},
"include_cta": {
"type": "boolean",
"description": "include a clear call-to-action"
}
},
"required": [
"generation_type",
"tone"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪generate_campaign_content(campaign_name, objective, target_audience, key_benefits, tone)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"campaign_name": {
"type": "string",
"minLength": 1,
"description": "campaign name (used as the brief title)"
},
"objective": {
"type": "string",
"minLength": 1,
"description": "campaign objective (e.g. 'book DJ gigs', 'sell SaaS to VPs of Eng')"
},
"target_audience": {
"type": "string",
"minLength": 1,
"description": "target audience description"
},
"key_benefits": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "non-empty list of key benefits to emphasise"
},
"tone": {
"type": "string",
"minLength": 1,
"description": "tone (e.g. professional, casual, warm-direct)"
}
},
"required": [
"campaign_name",
"objective",
"target_audience",
"key_benefits",
"tone"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢analyze_response(conversation_id, message_content)
analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires generate scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
},
"message_content": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "message content to analyze"
}
},
"required": [
"conversation_id",
"message_content"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_ai_usage
get AI generation usage limits and current counts for the billing period. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_contacts(keywords, location, radius_miles, max_results, sources, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "non-empty array of search keywords (e.g. ['boutique hotel', 'rooftop venue'])"
},
"location": {
"type": "string",
"description": "location for geo-scoped goals (local_business / venue / brick-and-mortar). omit for global goals (creators, b2b, saas)."
},
"radius_miles": {
"type": "number",
"exclusiveMinimum": 0,
"default": 25,
"description": "search radius in miles (default 25)"
},
"max_results": {
"type": "integer",
"minimum": 10,
"maximum": 500,
"description": "max contacts to return (10-500, default 50; server clamps to plan cap)"
},
"sources": {
"type": "array",
"items": {
"type": "string",
"enum": [
"google_maps",
"instagram",
"twitter",
"tiktok",
"reddit"
]
},
"description": "override the default per-profile_type source mix. valid: google_maps, instagram, twitter, tiktok, reddit. omit to let the orchestrator pick."
},
"profile_type": {
"type": "string",
"enum": [
"local_business",
"content_creator",
"influencer",
"b2b_professional",
"ecommerce",
"saas_company",
"agency",
"freelancer",
"other"
],
"description": "ICP profile type — drives default source mix when sources is omitted"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "campaign to attach discovered contacts to on finalize"
},
"enrich_emails": {
"type": "boolean",
"default": true,
"description": "run waterfall email enrichment (BetterContact → FullEnrich → ZeroBounce). default true."
}
},
"required": [
"keywords"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_campaign_contacts(campaign_id, target_profile_id)
search for contacts matching a campaign's target profiles. requires generate scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
},
"target_profile_id": {
"type": "string",
"format": "uuid",
"description": "specific target profile to search for"
}
},
"required": [
"campaign_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_discovery_job(id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "discovery job ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_discovery_sources
list available discovery data sources and their status. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_analytics_overview
get a high-level overview of all campaign analytics. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_campaign_analytics(id)
get detailed analytics for a specific campaign. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "campaign ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_performance_metrics(days, campaign_id)
get email performance metrics over time. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"maximum": 90,
"description": "time window in days (1–90, default 30)"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "filter by campaign ID"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_response_time(campaign_id)
get average response time analytics. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "filter by campaign ID"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_contact_types
get breakdown of contacts by type/source. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_billing_plans
get all available billing plans with pricing and feature limits. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_connected_accounts
list all connected social media accounts. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_channel_availability
check which outreach channels are available and configured. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴send_channel_message(channel, conversation_id, recipient_id, content, subject)
send a message through a specific channel in a conversation. requires send scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"channel": {
"type": "string",
"enum": [
"email",
"instagram",
"twitter"
],
"description": "outreach channel to use"
},
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
},
"recipient_id": {
"type": "string",
"minLength": 1,
"description": "recipient (email address for email channel; platform handle/ID for social channels)"
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "message content"
},
"subject": {
"type": "string",
"description": "subject (email channel only)"
}
},
"required": [
"channel",
"conversation_id",
"recipient_id",
"content"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_notifications(page, page_size)
list user notifications. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_notification(id, read)
update a notification (e.g., mark as read). requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "notification ID"
},
"read": {
"type": "boolean",
"description": "mark as read or unread"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_notification(id)
delete a notification. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "notification ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡mark_all_notifications_read
mark all notifications as read. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_usage
get your current plan, quota usage (campaigns used/remaining this period), and billing period (requires read scope)
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_changelog
machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡configure_autopilot(enabled, campaign_id, max_new_contacts_per_run, max_pending_reviews, run_hour, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"description": "turn the nightly loop on or off (enabling requires a campaign_id and clears pause state)"
},
"campaign_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"description": "the ONE standing campaign autopilot tends (draft, scheduled, or active); null to unset"
},
"max_new_contacts_per_run": {
"type": "integer",
"minimum": 10,
"maximum": 50,
"description": "discovery batch size per nightly run (default 10)"
},
"max_pending_reviews": {
"type": "integer",
"minimum": 5,
"maximum": 200,
"description": "skip discovery while this many drafts sit unreviewed (default 25)"
},
"run_hour": {
"type": "integer",
"minimum": 0,
"maximum": 23,
"description": "local hour the nightly run fires (default 2)"
},
"timezone": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "IANA timezone for run_hour (default America/New_York)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴configure_responder(enabled, auto_reply, instructions, booking_url, qualifying_questions, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"description": "thread Instagram DMs from anyone into the inbox. turning it off also turns auto_reply off. true clears any pause state."
},
"auto_reply": {
"type": "boolean",
"description": "let iris send replies itself, with no review. requires enabled, and either instructions or a profile background to answer from."
},
"instructions": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "what you offer, prices, answers to common questions, tone; null to unset"
},
"booking_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 500
},
{
"type": "null"
}
],
"description": "shared when someone asks to talk or book (https url); null to unset"
},
"qualifying_questions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 5,
"description": "asked one per message, in order, before the booking link is shared (max 5 items)"
},
"disclosure": {
"anyOf": [
{
"type": "string",
"minLength": 10,
"maxLength": 200
},
{
"type": "null"
}
],
"description": "the line that says the reply is automated, sent once per conversation with the first reply; null uses the default"
},
"max_replies_per_conversation": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "after this many automatic replies the conversation is handed to you (default 8)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_responder_activity(page, page_size)
list the responder's activity log (replies sent, handoffs, skips, and failures), newest first. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_conversation_responder(conversation_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
}
},
"required": [
"conversation_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴set_conversation_responder(conversation_id, status)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "conversation ID"
},
"status": {
"type": "string",
"enum": [
"active",
"paused"
],
"description": "new responder status for this conversation"
}
},
"required": [
"conversation_id",
"status"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴create_responder_comment_trigger(keyword, message, media_id, enabled)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "matched as a whole word or phrase in the comment, case-insensitive (1-50 characters)"
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 900,
"description": "the DM sent to the commenter, before the automated notice (1-900 characters, and at most 700 bytes)"
},
"media_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5,40}$"
},
{
"type": "null"
}
],
"description": "the numeric instagram media id to limit the trigger to one post (5-40 digits; get it from list_responder_posts); omit or send null to match every post"
},
"enabled": {
"type": "boolean",
"description": "whether the trigger is active (default true)"
}
},
"required": [
"keyword",
"message"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴update_responder_comment_trigger(id, keyword, message, media_id, enabled)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "comment trigger ID"
},
"keyword": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "matched as a whole word or phrase in the comment, case-insensitive (1-50 characters)"
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 900,
"description": "the DM sent to the commenter, before the automated notice (1-900 characters, and at most 700 bytes)"
},
"media_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5,40}$"
},
{
"type": "null"
}
],
"description": "the numeric instagram media id to limit the trigger to one post (5-40 digits; get it from list_responder_posts); null matches every post"
},
"enabled": {
"type": "boolean",
"description": "whether the trigger is active"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_responder_comment_trigger(id)
delete a comment trigger. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "comment trigger ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_audiences(page, page_size)
list the audience library - reusable target profiles created once and attachable to any campaign. requires read scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default 50, max 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_audience(name, profile_type, description, fit_score, job_titles, ...)
create a library audience profile manually. names are unique per library (case-insensitive). requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "audience name"
},
"profile_type": {
"type": "string",
"enum": [
"local_business",
"content_creator",
"influencer",
"b2b_professional",
"ecommerce",
"saas_company",
"agency",
"freelancer",
"other"
],
"description": "target profile type"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "who this audience is"
},
"fit_score": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "how well this audience fits (0-100)"
},
"job_titles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "target job titles"
},
"industries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "target industries"
},
"pain_points": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "problems they feel"
},
"buying_signals": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "signals they're ready to buy"
},
"discovery_keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "keywords for contact discovery"
},
"outreach_angle": {
"type": "string",
"maxLength": 500,
"description": "the hook messages should lead with"
}
},
"required": [
"name",
"profile_type"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪generate_audiences(product_name, product_url, product_description)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "product name"
},
"product_url": {
"type": "string",
"format": "uri",
"description": "product website - scraped for extra context"
},
"product_description": {
"type": "string",
"maxLength": 2000,
"description": "what it does and who it's for"
}
},
"required": [
"product_name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡attach_audience_to_campaign(id, campaign_id)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "audience (library profile) ID"
},
"campaign_id": {
"type": "string",
"format": "uuid",
"description": "campaign to attach to (must be yours and not completed or deleted)"
}
},
"required": [
"id",
"campaign_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_audience(id)
delete a library audience profile. campaigns it was attached to keep their copy. requires write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "audience (library profile) ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis