MCP Server

Endpoint: POST https://app.neureus.ai/mcp
Protocol: JSON-RPC 2.0, MCP spec 2024-11-05 (Streamable HTTP)
Auth: Authorization: Bearer <api_key> (D1 API key lookup — not x-tenant-id)

Overview

The MCP server exposes Neureus capabilities to Claude, GPT-4o, and any MCP-compatible agent runtime. HTTP 200 for valid RPC (including error envelopes). HTTP 202 for notifications. HTTP 400/503 for transport failures only.

Available tools

Tool	Description
neureus_chat	AI chat completion via the gateway
neureus_rag_query	Semantic search over ingested documents
neureus_agent_run	Execute a named agent
neureus_composite_execute	Run a composite AI pattern
neureus_models	List available models
neureus_health	Check platform health
neureus_org_create	Create an organization
neureus_org_get	Get org details and members
neureus_org_add_tenant	Add a tenant to an org

Connecting Claude to Neureus

In your Claude MCP configuration:

{
  "mcpServers": {
    "neureus": {
      "url": "https://app.neureus.ai/mcp",
      "headers": {
        "Authorization": "Bearer nru_your_api_key"
      }
    }
  }
}

Example JSON-RPC call

curl -X POST https://app.neureus.ai/mcp \
  -H "Authorization: Bearer nru_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "neureus_chat",
      "arguments": {
        "messages": [{"role": "user", "content": "Hello from MCP!"}],
        "model": "meta-llm"
      }
    }
  }'