Tellodb
Sign up

Section

Fundamentals

OverviewQuickstartInstallCore Concepts
Platform

MCP Server (Model Context Protocol)

Connect Tellodb to any MCP-compatible client — Claude Desktop, Cursor, Windsurf, and more — with zero configuration.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI assistants with external tools and data sources. Tellodb exposes an MCP server that lets any MCP-compatible client — including Claude Desktop, Cursor, and Windsurf — query memories, store facts, and explore knowledge graphs directly.

By supporting MCP, Tellodb works with every MCP client out of the box. No custom SDKs or integration code needed.

Available Tools

MetricToolDescriptionRequired Params
search_memorySearch memories with hybrid vector+lexical retrievalquery
store_factStore a new fact or observationtext, entity_id
explore_graphWalk the knowledge graph from an entityentity
get_memoryRetrieve a specific memory by IDmemory_id

Quick Start — Claude Desktop

  1. Open Claude Desktop → Settings → Developer → Edit Config.
  2. Add the following entry to your claude_desktop_config.json:
  3. Restart Claude Desktop. You should see the Tellodb tools in the toolbox.
  4. Ask Claude to "search my memories" or "store that Alice likes hiking".
claude_desktop_config.json
{
  "mcpServers": {
    "tellodb": {
      "command": "npx",
      "args": ["@tellodb/mcp-client"],
      "env": {
        "TELLODB_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Server Endpoint

  • The MCP server is available at: https://api.tellodb.com/mcp
  • Authentication is via x-api-key header or Bearer token in the Authorization header.
  • The protocol uses JSON-RPC 2.0 over HTTP POST.
  • A server card is available at: https://tellodb.com/.well-known/mcp/server-card.json
  • Install the MCP client package: npm install @tellodb/mcp-client