mcp.md
title: "MCP" description: "The remote MCP server endpoint (stateless JSON-RPC over Streamable HTTP), its description document and signed attachment links, with API key or OAuth auth." canonical: "https://machinemail.dev/docs/reference/api/mcp"
MCP
The remote MCP server endpoint (stateless JSON-RPC over Streamable HTTP), its description document and signed attachment links, with API key or OAuth auth.
Source: https://machinemail.dev/docs/reference/api/mcp
| Method | Path | Summary |
|---|---|---|
GET |
/.well-known/mcp.json |
MCP Server Description |
GET |
/mcp |
MCP Description or Stream |
POST |
/mcp |
MCP JSON-RPC (Streamable HTTP) |
DELETE |
/mcp |
MCP Session Termination (Unsupported) |
GET |
/mcp/attachments/{token} |
Download Attachment (Signed Link) |
MCP Server Description
GET /.well-known/mcp.json
Same document as a plain GET /mcp.
Authentication: None.
Response
200 How to connect (application/json)
| Field | Type | Description | |
|---|---|---|---|
name |
string |
required | |
description |
string |
required | What the server is for, in one line. |
icons |
object[] |
required | The MachineMail mark, for clients and registries that show an icon. |
version |
string |
required | |
transport |
` |