MCP tools reference#

relata mcp config --client claude    # prints a claude_desktop_config.json snippet
relata mcp config --client cursor    # Cursor IDE config
relata mcp config --client cline     # Cline / Roo
relata mcp config --client stdio     # raw stdio config

{
  "name": "search_knowledge",
  "description": "Search across ingested knowledge content — documents, entities, and relationships — using free-text query.",
  "inputSchema": {
    "type": "object",
    "required": ["query"],
    "properties": {
      "query": { "type": "string" },
      "purpose": { "type": "string" },
      "type_filter": { "type": "string", "description": "Restrict results to a content type: text, person, organization, location, relationship, answer." },
      "source_filter": { "type": "string", "description": "Restrict to content from this document/source." },
      "limit": { "type": "integer", "default": 20 },
      "min_confidence": { "type": "number", "default": 0.0 },
      "fuzzy": {
        "type": ["boolean", "object"],
        "description": "Bounded typo tolerance: true, or an object with edit_distance 1 or 2."
      }
    }
  }
}

{
  "content": [
    { "type": "text", "text": "..." },
    { "type": "json", "json": { } }
  ],
  "isError": false,
  "meta": {
    "processing_time_ms": 42
  }
}

# Register a scoped dynamic bearer token via the admin token surface
# (POST /admin/tokens writes to the in-memory + on-disk token registry).
# Give each agent a dedicated principal with the minimum required permissions.

curl -X POST http://localhost:9090/mcp/initialize \
  -H "Authorization: Bearer $RELATA_TOKEN"
 
# Response:
# {
#   "protocol_version": "2024-11-05",
#   "server_info": { "name": "relata", "version": "...", "profile": "...", "node_id": "..." },
#   "capabilities": { "tools": { "list_changed": false }, ... },
#   "tools": [ { "name": "query", ... }, ... ]
# }

curl -X POST http://localhost:9090/mcp/tools/call \
  -H "Authorization: Bearer $RELATA_TOKEN" \
  -H "X-Organization-Id: org-acme" \
  -d '{"name": "query", "arguments": {"sql": "SELECT * FROM Person LIMIT 5", "purpose": "analytics"}}'

{
  "mcpServers": {
    "relata": {
      "command": "npx",
      "args": ["-y", "relata-mcp-bridge"],
      "env": {
        "RELATA_URL": "http://localhost:9090",
        "RELATA_TOKEN": "relata-dev"
      }
    }
  }
}

from relata_adapters.langchain import RelataMemory
 
mem = RelataMemory(base_url="http://localhost:9090", purpose="research")
# chain = ConversationChain(llm=..., memory=mem)
# save_context stores each turn; load_memory_variables recalls the most
# relevant prior memories for the incoming input.

curl -X POST http://localhost:9090/mcp/tools/call \
  -H "Authorization: Bearer $RELATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "search_knowledge",
    "arguments": {
      "query": "governance policy for cross-border data sharing",
      "purpose": "investigation",
      "limit": 5,
      "fuzzy": true
    }
  }'

# Strict (default) — only registered purposes
RELATA_PURPOSE_MODE=strict
RELATA_PURPOSES=analytics,audit,compliance,operations
 
# Open — any non-empty string (dev/test only)
RELATA_PURPOSE_MODE=open

{
  "content": [{ "type": "text", "text": "error message" }],
  "isError": true
}