Remote MCP

The Remote MCP server exposes AutoMem over HTTPS, enabling cloud-based AI platforms to access your memories without local installation. It is also the recommended default for Anthropic surfaces when you want one shared MCP connection across Claude Desktop, Claude.ai, and iOS, because connector state now syncs between those clients.

Transport Options

AutoMem supports two MCP transport protocols:

Transport	Protocol Version	Status	Endpoint
Streamable HTTP	2025-03-26	✅ Recommended	`/mcp`
SSE (Server-Sent Events)	2024-11-05	⚠️ Deprecated	`/mcp/sse`

Streamable HTTP is the newer, recommended transport. AutoMem serves /mcp in stateless mode for broad client compatibility, so clients can treat each request independently and don't need long-lived server-side session continuity.

SSE is still supported for backward compatibility with older clients.

Why Use the MCP Bridge?

Use Case: Cloud AI Platforms

Most AI platforms (ChatGPT, Claude.ai, ElevenLabs) run in the cloud and can't connect to local MCP servers. The MCP bridge solves this by:

Running alongside your AutoMem API on Railway
Exposing MCP tools over HTTPS (Streamable HTTP or SSE)
Allowing cloud platforms to store and recall memories

flowchart TB
    subgraph cloud [Cloud AI Platforms]
        ChatGPT[ChatGPT]
        ClaudeAI[Claude.ai]
        ClaudeMobile[Claude Mobile]
        ElevenLabs[ElevenLabs Agents]
    end

    subgraph railway [Railway Deployment]
        MCPBridge[MCP Bridge<br/>Streamable HTTP<br/>Port 8080]

        subgraph automem [AutoMem Service]
            API[Memory Service API<br/>Port 8001]

            subgraph storage [Storage]
                FalkorDB[(FalkorDB)]
                Qdrant[(Qdrant)]
            end
        end
    end

    subgraph local [Local Development]
        Cursor[Cursor IDE]
        ClaudeDesktop[Claude Desktop]
        ClaudeCode[Claude Code]
        LocalMCP[Local MCP Package<br/>@verygoodplugins/mcp-automem]
    end

    ChatGPT -->|Streamable HTTP| MCPBridge
    ClaudeAI -->|Streamable HTTP| MCPBridge
    ClaudeMobile -->|Streamable HTTP| MCPBridge
    ElevenLabs -->|Streamable HTTP| MCPBridge

    MCPBridge -->|Internal networking<br/>railway.internal:8001| API

    API --> FalkorDB
    API --> Qdrant

    Cursor -.->|Direct connection| LocalMCP
    ClaudeDesktop -.->|Optional local package| LocalMCP
    ClaudeCode -.->|Direct connection| LocalMCP
    LocalMCP -.->|HTTP| API

When to Deploy It:

Platform	Needs MCP Bridge?	Notes
ChatGPT	✅ Yes	Web/mobile, uses MCP connectors
Claude.ai	✅ Yes	Web interface MCP support
Claude Mobile	✅ Yes	iOS/Android app
ElevenLabs Agents	✅ Yes	Voice AI with tool calling
Cursor IDE	❌ No	Use local `mcp-automem` package
Claude Desktop	✅ Usually yes	Recommended if you want the same connector enabled in Desktop, Claude.ai, and iOS
Claude Code	❌ No	Use local `mcp-automem` package

If you only use Cursor or Claude Code, you usually don't need the MCP bridge. Claude Desktop can still use the local MCP package, but disabling the remote connector there may also disable it for Claude.ai/iOS because Anthropic now syncs connector state across clients.

Local install:

npx @verygoodplugins/mcp-automem cursor  # or 'claude' or 'claude-code'

Deploy MCP Bridge on Railway

Already Using the Template?

The AutoMem Railway template includes mcp-sse-server by default. After deploying:

Go to Railway Dashboard → mcp-sse-server service
Click Settings → Networking → Generate Domain
Your MCP URL is: https://your-mcp-bridge.up.railway.app/mcp (Streamable HTTP)
- Legacy SSE: https://your-mcp-bridge.up.railway.app/mcp/sse

Skip to Client Setup below.

Adding MCP Bridge to an Existing Deployment

If you deployed before the MCP bridge was included, add it manually:

Create New Service
- In your Railway project, click + New Service
- Select GitHub Repo → verygoodplugins/automem
Configure Root Directory
- Settings → Root Directory: mcp-sse-server
- Railway will auto-detect the Dockerfile
Set Environment Variables
```
PORT=8080
AUTOMEM_API_URL=http://automem.railway.internal:8001
AUTOMEM_API_TOKEN=<copy from automem>
```
Important: Replace automem with your actual AutoMem API service name if different. Check with: railway variables --service <your-api-service> | grep RAILWAY_PRIVATE_DOMAIN
Configure Health Check
- Path: /health
- Timeout: 100s
Generate Public Domain
- Settings → Networking → Generate Domain
- Save your URL: https://your-mcp-bridge.up.railway.app

Supported Tools

The MCP bridge exposes these MCP tools:

Tool	Description
`store_memory`	Store a new memory with tags and importance
`recall_memory`	Semantic search across memories
`associate_memories`	Create relationships between memories
`update_memory`	Modify existing memory content or metadata
`delete_memory`	Remove a memory
`check_database_health`	Verify FalkorDB/Qdrant connectivity

Recall Ordering

associate_memories accepts only the 11 authorable semantic relationship types. Auto-generated labels such as SIMILAR_TO, PRECEDED_BY, and DISCOVERED remain readable on recall surfaces but are not exposed as authoring choices in the MCP schema.

recall_memory defaults to relevance ranking (sort: "score"). For chronological recaps (e.g. “what happened since X”), set:

sort: "time_desc" / sort: "time_asc" to order within a time window
sort: "updated_desc" / sort: "updated_asc" for the same ordering, named explicitly for updates

Example:

{ "time_query": "last 7 days", "sort": "time_desc" }

Client Setup

Endpoints

Transport	Endpoint	Purpose
Streamable HTTP (Recommended)	`POST /mcp`	Stateless JSON-RPC over HTTP
Streamable HTTP (Recommended)	`GET /mcp`	Optional SSE stream when `Accept: text/event-stream`
SSE (Deprecated)	`GET /mcp/sse`	SSE stream (server → client)
SSE (Deprecated)	`POST /mcp/messages?sessionId=<id>`	Client → server JSON-RPC
Shared	`GET /health`	Health probe

sequenceDiagram
    participant Client as AI Platform<br/>(ChatGPT/Claude)
    participant MCP as MCP Bridge<br/>Streamable HTTP
    participant API as AutoMem API<br/>automem
    participant DB as FalkorDB/Qdrant

    Note over Client,DB: Connection Establishment
    Client->>MCP: POST /mcp (initialize)
    MCP-->>Client: 200 OK + capabilities

    Note over Client,DB: Memory Operations
    Client->>MCP: POST /mcp<br/>tool: store_memory
    MCP->>API: POST /memory<br/>Authorization: Bearer xxx
    API->>DB: Store in graph + vectors
    DB-->>API: Success
    API-->>MCP: 201 Created
    MCP-->>Client: JSON-RPC response<br/>{status: success, memory_id: ...}

    Note over Client,DB: Recall Operation
    Client->>MCP: POST /mcp<br/>tool: recall_memory
    MCP->>API: GET /recall?query=...
    API->>DB: Hybrid search
    DB-->>API: Results
    API-->>MCP: 200 OK
    MCP-->>Client: JSON-RPC response<br/>{results: [...]}

    Note over Client,DB: Optional SSE Stream
    Client->>MCP: GET /mcp (Accept: text/event-stream)
    MCP-->>Client: SSE stream for server notifications

Authentication

Stateless Behavior

/mcp does not rely on server-side Streamable HTTP sessions. The bridge does not return an Mcp-Session-Id from initialize, and any incoming session header on /mcp is ignored. This matches current remote-client behavior more reliably across ChatGPT, Claude, and other hosted MCP clients.

Header-based (preferred when supported):

Authorization: Bearer <AUTOMEM_API_TOKEN>

URL-based (for platforms that only support OAuth):

https://your-mcp-bridge.up.railway.app/mcp/sse?api_token=<AUTOMEM_API_TOKEN>

Note: ?api_key= also works as an alias

ChatGPT Setup

ChatGPT supports MCP connectors. Use Streamable HTTP if supported, otherwise fall back to SSE:

Enable Developer Mode
- Settings → Connectors → Advanced → Enable Developer Mode

Add MCP Server

Click + Add Server

Server URL (try Streamable HTTP first):

https://your-mcp-bridge.up.railway.app/mcp?api_token=YOUR_TOKEN

Fallback (if Streamable HTTP not supported):

https://your-mcp-bridge.up.railway.app/mcp/sse?api_token=YOUR_TOKEN

Test It
- Ask ChatGPT: "Store a memory: I prefer dark mode in all applications"
- Then: "What are my preferences?"

Claude.ai Setup (Web)

Go to Settings → MCP Servers (or similar)

Server URL (Streamable HTTP):

https://your-mcp-bridge.up.railway.app/mcp?api_token=YOUR_TOKEN

Or SSE (if needed):

https://your-mcp-bridge.up.railway.app/mcp/sse?api_token=YOUR_TOKEN

Claude Mobile Setup (iOS/Android)

Open Settings → MCP Servers

Server URL:

https://your-mcp-bridge.up.railway.app/mcp?api_token=YOUR_TOKEN

ElevenLabs Agents Setup

ElevenLabs supports custom headers, giving you two options:

Option 1: Custom Header (Recommended)

Server URL: https://your-mcp-bridge.up.railway.app/mcp/sse
Custom Header:
- Name: Authorization
- Value: Bearer YOUR_TOKEN

Option 2: URL Parameter

Server URL: https://your-mcp-bridge.up.railway.app/mcp/sse?api_token=YOUR_TOKEN

Using with Voice Agents: ElevenLabs agents can use AutoMem to:

Remember user preferences across conversations
Recall context from previous sessions
Store important decisions and facts

Example agent prompt:

You have access to a persistent memory system. Use store_memory to save
important user preferences, decisions, and facts. Use recall_memory to
retrieve relevant context before answering questions.

Troubleshooting

"fetch failed" or Connection Refused

Check the AutoMem API service has PORT=8001
- Most common cause. Without it, Flask defaults to port 5000.
- Fix: Add PORT=8001 to the AutoMem API service environment variables.
Verify AUTOMEM_API_URL
- Should match your AutoMem API service's internal domain:
```
AUTOMEM_API_URL=http://automem.railway.internal:8001
```
- Check actual domain: railway variables --service automem | grep RAILWAY_PRIVATE_DOMAIN
Check SSE service logs
```
railway logs --service automem-mcp-sse
```
Fallback: Use public URL
- If internal networking fails, use the public URL (slower but works):
```
AUTOMEM_API_URL=https://your-automem.up.railway.app
```

Connection Drops

Streamable HTTP (recommended):

/mcp is stateless, so reconnects do not depend on a server-side session surviving
Clients can retry initialize or tool calls directly without waiting for session recovery
If a client sends a stale Mcp-Session-Id, the bridge ignores it on /mcp

SSE (deprecated):

Keepalive heartbeats are sent every 20 seconds
Some proxies/firewalls may still timeout; check platform-specific limits
ElevenLabs has a 30-second idle timeout; ensure heartbeats are reaching client

Authentication Errors

401 Unauthorized: Check token matches AUTOMEM_API_TOKEN in the AutoMem API service
URL tokens in logs: Normal for URL-based auth; use header auth if security is critical

Advanced: Alexa Integration

The MCP bridge also includes an Alexa skill endpoint:

Endpoint: POST /alexa

Supported Intents:

RememberIntent: "Alexa, tell AutoMem to remember {note}"
RecallIntent: "Alexa, ask AutoMem what I said about {query}"

Setup:

Create Alexa Custom Skill in developer console
Point HTTPS endpoint to: https://your-mcp-bridge.up.railway.app/alexa
Configure intents with sample utterances

See mcp-sse-server/README.md for full Alexa configuration.

Security Notes

URL tokens appear in logs: If using ?api_token=, be aware tokens may be logged by proxies
Internal networking: Railway private domains are only accessible within your project
Rate limiting: Consider adding a reverse proxy with rate limiting for production
Token rotation: Rotate AUTOMEM_API_TOKEN periodically via Railway dashboard

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Remote MCP

Transport Options

Why Use the MCP Bridge?

Deploy MCP Bridge on Railway

Already Using the Template?

Adding MCP Bridge to an Existing Deployment

Supported Tools

Recall Ordering

Client Setup

Endpoints

Authentication

Stateless Behavior

ChatGPT Setup

Claude.ai Setup (Web)

Claude Mobile Setup (iOS/Android)

ElevenLabs Agents Setup

Troubleshooting

"fetch failed" or Connection Refused

Connection Drops

Authentication Errors

Advanced: Alexa Integration

Security Notes

FilesExpand file tree

MCP_SSE.md

Latest commit

History

MCP_SSE.md

File metadata and controls

Remote MCP

Transport Options

Why Use the MCP Bridge?

Deploy MCP Bridge on Railway

Already Using the Template?

Adding MCP Bridge to an Existing Deployment

Supported Tools

Recall Ordering

Client Setup

Endpoints

Authentication

Stateless Behavior

ChatGPT Setup

Claude.ai Setup (Web)

Claude Mobile Setup (iOS/Android)

ElevenLabs Agents Setup

Troubleshooting

"fetch failed" or Connection Refused

Connection Drops

Authentication Errors

Advanced: Alexa Integration

Security Notes