{"serverId":"mcp-registry/io.github.runearc-labs/runearc","tools":[{"name":"bulk_contacts","fixed":{"name":"bulk_contacts","description":"Tag, add to a list, unsubscribe or delete many contacts at once. Give exactly one of contact_ids, emails or all_matching. Returns the operation {id, status, total, ...}; it runs in the background. Errors: invalid_body, too_many_targets, invalid_tags, empty_selection, not_found (list). Next: unsubscribe_contacts for plain unsubscribes; list_suppressions to review who is blocked.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["action"],"properties":{"tags":{"type":"array","items":{"type":"string"},"default":[],"description":"For \"tag\": the tags to add."},"action":{"type":"string","description":"\"tag\", \"add_to_list\", \"unsubscribe\" or \"delete\"."},"emails":{"type":["array","null"],"items":{"type":"string"},"default":null,"description":"Email addresses of contacts."},"list_id":{"type":["string","null"],"default":null,"description":"For \"add_to_list\": the list id (lst_...)."},"contact_ids":{"type":["array","null"],"items":{"type":"string"},"default":null,"description":"Contact ids (ctc_...). Give exactly one of contact_ids, emails or all_matching."},"all_matching":{"default":null,"description":"Act on every contact matching this filter {q, status, tag, list_id}; {} means all contacts.","type":"string"}}},"annotations":{"title":"Bulk update contacts","readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":true},"title":"Bulk update contacts"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: all_matching. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":363,"tokensAfter":368},{"name":"create_event_definition","fixed":{"name":"create_event_definition","description":"Document a custom event so teammates know what it means. Returns the definition. Errors: event_definition_exists, invalid_event_name, reserved_event_name. Next: track_event to send it, or create_sync_rule.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["name"],"properties":{"name":{"type":"string","description":"The event name, such as \"plan_upgraded\"."},"properties":{"default":null,"description":"Documentation of the properties: [{\"name\": \"plan\", \"type\": \"string\"}]. Not enforced.","type":"string"},"description":{"type":["string","null"],"default":null,"description":"What the event means."}}},"annotations":{"title":"Create event definition","readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"title":"Create event definition"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: properties. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":194,"tokensAfter":199},{"name":"create_goal","fixed":{"name":"create_goal","description":"Create a conversion goal. Each matching event records a conversion credited to the last email sent or clicked within window_days. Returns the goal. Errors: goal_exists, invalid_window (1 to 90), invalid_event_name. Next: track_event to convert, then goal_stats.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["name","event_name"],"properties":{"name":{"type":"string","description":"A unique name, such as \"Upgraded to pro\"."},"conditions":{"default":null,"description":"Optional property conditions, same shape as for sync rules.","type":"string"},"event_name":{"type":"string","description":"The event that counts as a conversion."},"window_days":{"type":["integer","null"],"format":"int32","default":null,"description":"Attribution window in days, 1 to 90 (default 7): an email sent or clicked this long before gets the credit."},"value_property":{"type":["string","null"],"default":null,"description":"Property holding the revenue of the event, such as \"amount\"."}}},"annotations":{"title":"Create goal","readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"title":"Create goal"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: conditions. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":292,"tokensAfter":297},{"name":"create_segment","fixed":{"name":"create_segment","description":"Save a segment (a named audience filter over contacts). Returns the segment. Errors: invalid_filter (read the fix), segment_name_taken, segment_limit. Next: preview_segment, then use the id as the audience of a campaign.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["name","filter"],"properties":{"name":{"type":"string","description":"Segment name, unique in the workspace."},"filter":{"description":"The filter: {\"type\":\"group\",\"op\":\"and\"|\"or\",\"children\":[...]}. Conditions: {\"type\":\"tag\",\"tag\":\"vip\",\"has\":true},\n{\"type\":\"status\",\"is\":[\"active\"]}, {\"type\":\"list\",\"list_id\":\"lst_..\",\"member\":true},\n{\"type\":\"field\",\"field\":\"email|first_name|last_name|fields.<key>\",\"op\":\"eq|ne|contains|starts_with|gt|gte|lt|lte|is_set|is_not_set\",\"value\":\"..\"},\n{\"type\":\"engagement\",\"action\":\"sent|opened|clicked|engaged\",\"within_days\":30,\"min_count\":1,\"negate\":false},\n{\"type\":\"event\",\"name\":\"..\",\"within_days\":14}, {\"type\":\"date\",\"field\":\"created_at\",\"op\":\"within_last_days|older_than_days|before|after\",\"days\":7}.","type":"string"},"description":{"type":"string","default":"","description":"What it is for."}}},"annotations":{"title":"Create segment","readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"title":"Create segment"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: filter. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":355,"tokensAfter":360},{"name":"create_sync_rule","fixed":{"name":"create_sync_rule","description":"Create a sync rule: when event_name happens and all conditions match, apply the action to the contact. Returns the rule. Errors: invalid_argument, invalid_event_name, list_not_found, field_not_found (create the contact field first), invalid_tag. Next: track_event to try it, then get_contact or list_contact_events to see the result.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["name","event_name","action"],"properties":{"name":{"type":"string","description":"A name for the rule, such as \"Tag pro customers\"."},"action":{"description":"What to do: {\"type\": \"add_tag\", \"tag\": \"customer\"}, {\"type\": \"remove_tag\", \"tag\": \"trial\"},\n{\"type\": \"set_field\", \"key\": \"plan\", \"value\": \"pro\"} or {\"type\": \"add_to_list\", \"list_id\": \"lst_...\"}.","type":"string"},"conditions":{"default":null,"description":"All must match: [{\"path\": \"plan\", \"op\": \"eq\", \"value\": \"pro\"}]. Ops: eq, neq, gt, gte, lt, lte, contains, exists.","type":"string"},"event_name":{"type":"string","description":"The event that triggers it, custom or built-in (for example \"plan_upgraded\" or \"tag.added\")."}}},"annotations":{"title":"Create sync rule","readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"title":"Create sync rule"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: action, conditions. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":331,"tokensAfter":340},{"name":"preview_segment","fixed":{"name":"preview_segment","description":"Live count and a sample of contacts for a segment id or a draft filter, without saving. Returns {count, sample:[{id,email,first_name,last_name,status}]}. Engagement and event conditions match nobody until tracking data exists. Next: create_segment to save it.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"limit":{"type":["integer","null"],"format":"int64","default":null,"description":"Sample size, 1 to 100. Default 10."},"filter":{"default":null,"description":"A draft filter, same shape as create_segment.","type":"string"},"segment_id":{"type":["string","null"],"default":null,"description":"A saved or built-in segment id (seg_..., builtin_engaged). Give this or `filter`."}}},"annotations":{"title":"Preview segment","readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"title":"Preview segment"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: filter. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":213,"tokensAfter":218},{"name":"render_email_preview","fixed":{"name":"render_email_preview","description":"Render an email document with the workspace brand, without sending. Returns {subject, html, text}. Errors: invalid_document, unknown_variable (add a fallback like {{FIRST_NAME|Friend}} or pass vars), missing_address, invalid_variable. Next: send it, or fix the document and render again.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["document"],"properties":{"vars":{"type":["object","null"],"default":null,"description":"Values for {{NAME}} variables, such as {\"FIRST_NAME\":\"Ana\"}.","additionalProperties":{"type":"string"}},"document":{"description":"The email document: {version:1, style:\"designed\"|\"plain\", subject, preheader?,\nblocks:[{type:\"heading\",text,level}|{type:\"text\",text}|{type:\"button\",label,url}|\n{type:\"image\",src,alt,href?}|{type:\"divider\"}|{type:\"footer\",unsubscribe}|\n{type:\"rows\",rows:[[label,value],...]}|{type:\"code\",code}]}.","type":"string"}}},"annotations":{"title":"Render email preview","readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"title":"Render email preview"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: document. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":274,"tokensAfter":278},{"name":"send_template","fixed":{"name":"send_template","description":"Send an email from a published transactional template. Returns {id}. Errors: template_not_found, template_not_published, missing_variable (names the variable), invalid_variable, template_conflict, recipient_suppressed, daily_send_limit_reached, sending_paused. Next: wait_for_email or create_webhook for delivery events.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["template","from","to"],"properties":{"to":{"type":"array","items":{"type":"string"}},"from":{"type":"string","description":"Sender on a verified domain, such as \"Acme <noreply@acme.com>\"."},"subject":{"type":["string","null"],"default":null,"description":"Overrides the template subject."},"template":{"type":"string","description":"Template slug or tpl_ id. Must have a published version."},"variables":{"default":null,"description":"Values for the template variables, for example {\"RESET_URL\": \"https://...\"}.","type":"string"}}},"annotations":{"title":"Send template email","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"title":"Send template email"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: variables. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":274,"tokensAfter":278},{"name":"track_event","fixed":{"name":"track_event","description":"Record that a contact did something, such as plan_upgraded. Runearc then applies sync rules (tags, fields, lists) and goals. Returns the event with duplicate=true when the idempotency_key was seen before. Errors: contact_not_found (create the contact first), reserved_event_name, invalid_event_name, invalid_properties, properties_too_large, idempotency_key_reused. Next: list_contact_events to confirm it, or create_sync_rule to react to it.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["email","name"],"properties":{"name":{"type":"string","description":"The event name: lowercase letters, digits and _ . : - starting with a letter, such as\n\"plan_upgraded\". Built-in names (email.opened, tag.added, ...) are reserved."},"email":{"type":"string","description":"Email of an existing contact the event is about."},"properties":{"default":null,"description":"Event properties as a JSON object, up to 16 KB, such as {\"plan\": \"pro\", \"amount\": 49}.","type":"string"},"idempotency_key":{"type":["string","null"],"default":null,"description":"Repeating the same key returns the first event instead of recording a second one."}}},"annotations":{"title":"Track contact event","readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"title":"Track contact event"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: properties. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":336,"tokensAfter":340},{"name":"update_campaign","fixed":{"name":"update_campaign","description":"Edit a draft campaign: name, subject, preheader, from_address (a verified sender), reply_to, document (email design JSON) and audience ({kind:list,id} | {kind:segment,id} | {kind:tag,name}). Only drafts can be edited. Errors: campaign_not_editable, invalid_address, invalid_document, invalid_field, not_found. Next: send_campaign_test, then send_campaign.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id"],"properties":{"id":{"type":"string","description":"The campaign id (cmp_...)."},"name":{"type":["string","null"],"default":null},"subject":{"type":["string","null"],"default":null,"description":"Subject line; variables like {{FIRST_NAME|there}} are allowed."},"audience":{"default":null,"description":"{kind:\"list\",id} | {kind:\"segment\",id} | {kind:\"tag\",name}.","type":"string"},"document":{"default":null,"description":"Email design document: {version:1, style, subject, blocks:[...]}.","type":"string"},"reply_to":{"type":["string","null"],"default":null},"preheader":{"type":["string","null"],"default":null},"from_address":{"type":["string","null"],"default":null,"description":"Sender address on a verified domain, such as news@example.com."}}},"annotations":{"title":"Update campaign","readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"title":"Update campaign"},"changes":[{"kind":"schema","detail":"Added \"type\":\"string\" to untyped parameters: audience, document. Change to number/boolean/array where that's what you accept.","verify":true}],"tokensBefore":342,"tokensAfter":351}],"toolsChanged":10,"tokensSaved":0,"todo":[{"tool":"add_contact","params":["last_name","first_name"]},{"tool":"create_list","params":["name","description"]},{"tool":"delete_segment","params":["segment_id"]},{"tool":"generate_sequence","params":["language","site_text"]},{"tool":"list_contacts","params":["tag","list_id"]},{"tool":"send_email","params":["subject"]},{"tool":"send_template","params":["to"]},{"tool":"update_campaign","params":["name","reply_to","preheader"]},{"tool":"update_contact","params":["source","last_name","revenue_cents"]},{"tool":"update_page","params":["name","slug"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}