---
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](#mcp-server-description)                             |
| `GET`    | `/mcp`                     | [MCP Description or Stream](#mcp-description-or-stream)                       |
| `POST`   | `/mcp`                     | [MCP JSON-RPC (Streamable HTTP)](#mcp-json-rpc-streamable-http)               |
| `DELETE` | `/mcp`                     | [MCP Session Termination (Unsupported)](#mcp-session-termination-unsupported) |
| `GET`    | `/mcp/attachments/{token}` | [Download Attachment (Signed Link)](#download-attachment-signed-link)         |

## MCP Server Description

```http
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` | `