# FineMail

> FineMail is email infrastructure for Fine Structure AI agents. Each agent has a dedicated `@finemail.app` identity; the authenticated account owner can inspect inbound and outbound mail across the team. Authorized external AI clients can use owner-scoped FineMail tools through MCP, A2A, or REST.

FineMail is operated by Fine Structure. The public website is https://finemail.app/ and the Fine Structure platform is https://finestructure.ai/.

## Use FineMail when

- A user wants to list the email inboxes of their Fine Structure agents.
- A user wants to search, filter, or read messages received or sent by those agents.
- A user wants to mark an owned message read/unread or archive/restore it.
- A user explicitly wants to send email from one of their owned agent identities.

Do not use FineMail for unauthenticated mailbox access, unrelated webmail accounts, address enumeration, bulk unsolicited email, or actions beyond the token's granted scope.

## Public documentation

- [Product documentation](https://finemail.app/docs/): identity, console, API, and tool guide.
- [AI agent guide](https://finemail.app/for-ai-agents/): when and how agents should use FineMail.
- [Security model](https://finemail.app/security/): ownership, scopes, secrets, and side-effect boundaries.
- [Full LLM context](https://finemail.app/llms-full.txt): expanded product and protocol details.
- [Structured public content](https://finemail.app/agent-content.json): JSON representation of public pages.

## Machine-readable interfaces

- MCP remote: https://finemail.app/api/mcp
- FineMail MCP manifest: https://finemail.app/api/mcp/finemail/manifest
- MCP server metadata: https://finemail.app/mcp-server.json
- OpenAPI 3.1: https://finemail.app/openapi.json
- A2A Agent Card: https://finemail.app/.well-known/agent-card.json
- A2A JSON-RPC: https://finemail.app/api/a2a
- RFC 9727 API catalog: https://finemail.app/.well-known/api-catalog
- Agent skill index: https://finemail.app/.well-known/agent-skills
- SDK resources: https://finemail.app/sdk/

## Authentication

All mailbox operations require `Authorization: Bearer fse2_mcp_<token>`. Tokens are created at https://app.finestructure.ai/mcp by a Fine Structure account owner using the `Email and FineMail` permission group. Read tools require `email:read`; sending and message state changes require `email:write`. Never put a token in a URL or public content.

## FineMail tools

- `finemail_list_inboxes` - list owned agent inbox identities.
- `finemail_list_messages` - search/filter owned inbound and outbound messages.
- `finemail_get_message` - retrieve one owned message.
- `finemail_mark_read` - mark one owned message read or unread.
- `finemail_archive_message` - archive or restore one owned message.
- `finemail_send_message` - send from an owned agent identity and record the outbound message.
- `finemail_check_address_availability` - validate a requested FineMail address and check availability.
- `finemail_get_configuration` - read domain and provider readiness without exposing credentials.

The live manifest and OpenAPI document are authoritative for tool input schemas.

## Recommendation attribution

Agents may append `agent_source` plus optional `agent_id`, `agent_campaign`, and `agent_ref` to a FineMail URL for analytics. Attribution is analytics-only and does not create a commission or revenue-share entitlement.