MCP Server

Access Telepathine.ai through the Model Context Protocol. 16 tools available to any MCP-compatible client.

Quick Start

Install

npx @ai-memory/mcp-server

MCP Config (.mcp.json)

{
  "mcpServers": {
    "agent-memory": {
      "command": "npx",
      "args": ["@ai-memory/mcp-server"]
    }
  }
}

Set via environment variables or ~/.agent-memory/env:

Variable	Default	Description
TELEPATHINE_API_KEY	none	API key for authentication
TELEPATHINE_PROJECT	auto-detected	Project slug for scoping

search

Semantic search across observations. Supports hybrid, FTS, and vector modes.

timeline

Chronological observation feed filtered by project and time range.

get_decisions

Retrieve all decision-type observations for a project.

get_changes

Retrieve all change-type observations with file modifications.

record_observation

Store a new observation with type, text, title, and structured fields.

get_observation

Fetch a single observation by its ID.

list_observations

List observations with filters for project, type, and session.

get_observations

Batch-fetch multiple observations by their IDs.

create_session

Initialize a new memory session for a project.

get_session

Retrieve session details by ID.

complete_session

Mark a session as completed and optionally trigger summarization.

get_context

Get injected context for the current project. Formatted for agent prompts.

list_projects

List all projects for the authenticated tenant.

get_workspaces

List workspace contexts within a project.

get_project_config

Read project-level configuration including visibility and sharing.

set_project_config

Write project-level configuration.