{"name":"finemail-mcp","version":"1.0.0","description":"FineMail MCP Server - dedicated AI-agent inboxes, incoming and outgoing messages, sending, message state, and address availability.","website":"https://finemail.app","tools":[{"name":"finemail_list_inboxes","description":"List the authenticated user's AI-agent inboxes, their FineMail addresses, and mailbox counts.","inputSchema":{"type":"object","properties":{"include_archived":{"type":"boolean","default":false,"description":"Include archived agent profiles."}},"additionalProperties":false}},{"name":"finemail_list_messages","description":"List owner-scoped FineMail messages, optionally filtered by agent, folder, or search text.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","description":"Optional owned agent ID."},"folder":{"type":"string","enum":["all","inbox","sent","unread","archived"],"default":"all"},"search":{"type":"string","maxLength":500,"default":""},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"additionalProperties":false}},{"name":"finemail_get_message","description":"Get one full incoming or outgoing FineMail message owned by the authenticated user.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120}},"required":["message_id"],"additionalProperties":false}},{"name":"finemail_send_message","description":"Send a rich RFC email from an owned AI agent identity and persist its delivery record.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"to":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"subject":{"type":"string","minLength":1,"maxLength":1000},"body":{"type":"string","maxLength":200000},"text_body":{"type":"string","maxLength":200000},"html_body":{"type":"string","maxLength":500000},"cc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"bcc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","maxLength":255},"content_base64":{"type":"string","maxLength":14000000},"inline":{"type":"boolean"},"content_id":{"type":"string","maxLength":255}},"required":["filename","content_base64"],"additionalProperties":false}},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4000}},"idempotency_key":{"type":"string","maxLength":200}},"required":["agent_id","to","subject"],"additionalProperties":false}},{"name":"finemail_mark_read","description":"Mark an owner-scoped FineMail message as read or unread.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120},"is_read":{"type":"boolean","default":true}},"required":["message_id"],"additionalProperties":false}},{"name":"finemail_archive_message","description":"Archive or restore an owner-scoped FineMail message.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120},"is_archived":{"type":"boolean","default":true}},"required":["message_id"],"additionalProperties":false}},{"name":"finemail_check_address_availability","description":"Validate a requested @finemail.app address and check whether it is globally available.","inputSchema":{"type":"object","properties":{"local_part":{"type":"string","minLength":1,"maxLength":320,"description":"An English local part or a complete @finemail.app address."},"exclude_agent_id":{"type":"string","maxLength":120,"description":"Optional owned agent ID when checking an address update."}},"required":["local_part"],"additionalProperties":false}},{"name":"finemail_get_configuration","description":"Read FineMail domain, sending, inbound-routing, and readiness configuration without exposing credentials.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"finemail_get_inbox","description":"Get one owned agent inbox and its usage counts.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["agent_id"]}},{"name":"finemail_create_inbox","description":"Create an owned AI-agent inbox with a meaningful available address.","inputSchema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"role":{"type":"string","maxLength":200},"local_part":{"type":"string","maxLength":320},"display_name":{"type":"string","maxLength":200},"company_name":{"type":"string","maxLength":200},"metadata":{"type":"object"}},"additionalProperties":false,"required":["name"]}},{"name":"finemail_update_inbox","description":"Update an owned inbox identity, address, display name, or metadata.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":200},"local_part":{"type":"string","maxLength":320},"display_name":{"type":"string","maxLength":200},"status":{"type":"string","enum":["active","archived","deleted"]},"metadata":{"type":"object"}},"additionalProperties":false,"required":["agent_id"]}},{"name":"finemail_delete_inbox","description":"Soft-delete an owned inbox while retaining its address and audit trail.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["agent_id"]}},{"name":"finemail_list_threads","description":"List and search conversation threads across owned inboxes.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"folder":{"type":"string","enum":["all","inbox","sent","unread","archived"],"default":"all"},"search":{"type":"string","maxLength":500},"labels":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":100},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"additionalProperties":false}},{"name":"finemail_get_thread","description":"Get a complete owned email conversation with messages.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["thread_id"]}},{"name":"finemail_update_thread","description":"Add or remove labels and update archive/read state across an owned thread.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","minLength":1,"maxLength":120},"add_labels":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":100},"remove_labels":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":100},"is_archived":{"type":"boolean"},"is_read":{"type":"boolean"}},"additionalProperties":false,"required":["thread_id"]}},{"name":"finemail_delete_thread","description":"Soft-delete an owned conversation thread.","inputSchema":{"type":"object","properties":{"thread_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["thread_id"]}},{"name":"finemail_reply_message","description":"Reply or reply-all to an owned message while preserving RFC thread headers.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120},"reply_all":{"type":"boolean","default":false},"cc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"bcc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"body":{"type":"string","maxLength":200000},"text_body":{"type":"string","maxLength":200000},"html_body":{"type":"string","maxLength":500000},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","maxLength":255},"content_base64":{"type":"string","maxLength":14000000},"attachment_id":{"type":"string","maxLength":120},"inline":{"type":"boolean"},"content_id":{"type":"string","maxLength":255}},"required":["filename"],"additionalProperties":false}}},"additionalProperties":false,"required":["message_id"]}},{"name":"finemail_forward_message","description":"Forward an owned message and optional original attachments.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120},"to":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"cc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"bcc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"body":{"type":"string","maxLength":200000},"text_body":{"type":"string","maxLength":200000},"html_body":{"type":"string","maxLength":500000},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","maxLength":255},"content_base64":{"type":"string","maxLength":14000000},"attachment_id":{"type":"string","maxLength":120},"inline":{"type":"boolean"},"content_id":{"type":"string","maxLength":255}},"required":["filename"],"additionalProperties":false}}},"additionalProperties":false,"required":["message_id","to"]}},{"name":"finemail_update_message","description":"Update labels, read, archive, or quarantine state on an owned message.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120},"add_labels":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":100},"remove_labels":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":100},"is_read":{"type":"boolean"},"is_archived":{"type":"boolean"},"is_quarantined":{"type":"boolean"}},"additionalProperties":false,"required":["message_id"]}},{"name":"finemail_delete_message","description":"Soft-delete an owned message.","inputSchema":{"type":"object","properties":{"message_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["message_id"]}},{"name":"finemail_list_drafts","description":"List draft and scheduled messages.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"status":{"type":"string","enum":["draft","scheduled","sending","sent","failed","cancelled"]},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"additionalProperties":false}},{"name":"finemail_get_draft","description":"Get one owned draft or scheduled message.","inputSchema":{"type":"object","properties":{"draft_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["draft_id"]}},{"name":"finemail_create_draft","description":"Create a draft or schedule it with an ISO-8601 send_at value.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"to":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"cc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"bcc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"subject":{"type":"string","maxLength":1000},"send_at":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":200000},"text_body":{"type":"string","maxLength":200000},"html_body":{"type":"string","maxLength":500000},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","maxLength":255},"content_base64":{"type":"string","maxLength":14000000},"attachment_id":{"type":"string","maxLength":120},"inline":{"type":"boolean"},"content_id":{"type":"string","maxLength":255}},"required":["filename"],"additionalProperties":false}}},"additionalProperties":false,"required":["agent_id"]}},{"name":"finemail_update_draft","description":"Update or reschedule an owned draft.","inputSchema":{"type":"object","properties":{"draft_id":{"type":"string","minLength":1,"maxLength":120},"to":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"cc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"bcc":{"oneOf":[{"type":"string","maxLength":320},{"type":"array","items":{"type":"string","maxLength":320},"minItems":1,"maxItems":50}]},"subject":{"type":"string","maxLength":1000},"send_at":{"type":["string","null"],"maxLength":80},"body":{"type":"string","maxLength":200000},"text_body":{"type":"string","maxLength":200000},"html_body":{"type":"string","maxLength":500000},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","maxLength":255},"content_base64":{"type":"string","maxLength":14000000},"attachment_id":{"type":"string","maxLength":120},"inline":{"type":"boolean"},"content_id":{"type":"string","maxLength":255}},"required":["filename"],"additionalProperties":false}}},"additionalProperties":false,"required":["draft_id"]}},{"name":"finemail_send_draft","description":"Send an owned draft immediately.","inputSchema":{"type":"object","properties":{"draft_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["draft_id"]}},{"name":"finemail_delete_draft","description":"Delete a draft or cancel a scheduled send.","inputSchema":{"type":"object","properties":{"draft_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["draft_id"]}},{"name":"finemail_wait_for_email","description":"Long-poll for a matching inbound email without frequent client polling.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":120},"from":{"type":"string","maxLength":320},"subject":{"type":"string","maxLength":500},"since":{"type":"string","maxLength":80},"timeout_seconds":{"type":"integer","minimum":1,"maximum":30,"default":25}},"additionalProperties":false,"required":["agent_id"]}},{"name":"finemail_get_attachment","description":"Get safe metadata and an owner-authenticated download path for an owned attachment.","inputSchema":{"type":"object","properties":{"attachment_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["attachment_id"]}},{"name":"finemail_list_webhooks","description":"List owner-scoped signed webhook subscriptions.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"finemail_create_webhook","description":"Create an HTTPS webhook and return its signing secret once.","inputSchema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2000},"events":{"type":"array","items":{"type":"string","maxLength":100},"minItems":1,"maxItems":20}},"additionalProperties":false,"required":["url","events"]}},{"name":"finemail_delete_webhook","description":"Delete an owned webhook subscription.","inputSchema":{"type":"object","properties":{"webhook_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["webhook_id"]}},{"name":"finemail_list_domains","description":"List custom domains and their verified DNS state.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"finemail_create_domain","description":"Start custom-domain onboarding and return required DNS records.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":1,"maxLength":253},"make_default":{"type":"boolean","default":false},"provision":{"type":"boolean","default":true}},"additionalProperties":false,"required":["domain"]}},{"name":"finemail_verify_domain","description":"Refresh DNS and SES verification state for an owned custom domain.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":1,"maxLength":253}},"additionalProperties":false,"required":["domain"]}},{"name":"finemail_list_security_rules","description":"List allow/block rules and inbound security policy.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"finemail_create_security_rule","description":"Create an allow or block rule for an address or domain.","inputSchema":{"type":"object","properties":{"kind":{"type":"string","enum":["allow","block"]},"pattern_type":{"type":"string","enum":["email","domain"]},"value":{"type":"string","minLength":1,"maxLength":320},"reason":{"type":"string","maxLength":500}},"additionalProperties":false,"required":["kind","value"]}},{"name":"finemail_delete_security_rule","description":"Delete an owned allow/block rule.","inputSchema":{"type":"object","properties":{"rule_id":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false,"required":["rule_id"]}},{"name":"finemail_get_usage","description":"Get owner-scoped inbox, storage, sending, delivery, security, quota, and plan usage.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}}],"authentication":{"type":"bearer","description":"Use a scoped MCP token from the connected Fine Structure account. Pass it as Authorization: Bearer fse2_mcp_<token>. Read tools require email:read and write tools require email:write."}}