MCP-API-Dokumentation

Überblick

Der E-Mail-API-Service implementiert das Model Context Protocol (MCP), das eine standardisierte Schnittstelle für die Bereitstellung von Tools bereitstellt. Dies ermöglicht die Integration mit MCP-kompatiblen Clients wie Claude Desktop, Cursor oder anderen AI-Assistenten.

MCP-Base-URL:

http://localhost:8000/mcp

Verfügbare Tools (16)

📁 Mailbox-Management (4)

list_mailboxes - Alle Ordner auflisten
create_mailbox - Ordner erstellen
delete_mailbox - Ordner löschen
rename_mailbox - Ordner umbenennen

📧 Message-Operations (10)

list_messages - E-Mails auflisten (mit Filtern)
get_message - E-Mail-Details abrufen
get_raw_message - RFC822-Format
move_message - E-Mail verschieben
copy_message - E-Mail kopieren
delete_message - E-Mail löschen
set_message_flags - Flags setzen
mark_message_seen - Als gelesen
mark_message_unseen - Als ungelesen
update_message_headers - Header ändern

📤 SMTP (2)

send_email - E-Mail versenden
send_email_with_attachments - Mit Attachments

Authentifizierung

Alle MCP-Tools benötigen Authentifizierung per API-Token:

Erforderliche Parameter:

{
  "account_id": 1,
  "api_token": "YOUR_API_TOKEN_HERE"
}

💡 Tipp: Ihren API-Token finden Sie im Dashboard.

Beispiel-Request

curl -X POST http://localhost:8000/mcp/tools/call \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_messages",
      "arguments": {
        "account_id": 1,
        "api_token": "YOUR_TOKEN",
        "mailbox": "INBOX",
        "limit": 5
      }
    }
  }'

Python-Client

from examples.mcp_client import EmailMCPClient

client = EmailMCPClient(
    base_url="http://localhost:8000",
    account_id=1,
    api_token="YOUR_TOKEN"
)

# Postfächer auflisten
mailboxes = client.list_mailboxes()

# E-Mails abrufen
messages = client.list_messages(limit=10)

# Als gelesen markieren
client.mark_seen(uid="12345")

Integration mit AI-Tools

Fügen Sie den MCP-Server zu Ihrer Cursor-Konfiguration hinzu:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "email-api": {
      "url": "http://localhost:8000/mcp",
      "env": {
        "EMAIL_ACCOUNT_ID": "1",
        "EMAIL_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

MCP-Spezifikation → GitHub →