Invoke project memory MCP endpoint

POST /api/v1/projects/{id}/mcp
Bearer auth

Forwards an MCP (Model Context Protocol) request to the project's memory tool server. The project scope is carried by the route id path parameter and the org is derived from that project. The body is a single JSON-RPC message; JSON-RPC batch requests are rejected. The upstream response is proxied back verbatim.

Path parameters

  • id string Required

    Project ID

Body Required

JSON-RPC message (forwarded to the project runtime as-is)

object object

Body Required

JSON-RPC message (forwarded to the project runtime as-is)

object object

Responses

  • 200 application/json

    MCP response, proxied verbatim
  • 400 application/json

    Project runtime not available, or a JSON-RPC batch request

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 401 application/json

    Missing or invalid credentials

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 403 application/json

    Caller lacks deployment-management permission

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 404 application/json

    MCP access not enabled for this project

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 413 application/json

    Request body exceeds the size limit

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 502 application/json

    Project runtime unreachable

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 503 application/json

    Project runtime does not serve MCP yet

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
POST /api/v1/projects/{id}/mcp 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/mcp' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json"
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/mcp' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: text/plain"
Request examples 
{}
Response examples (200) 
{}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (503) 
{
  "code": "string",
  "error": "string",
  "success": true
}