MCP Tools Reference

npx @fathippo/mcp-server

// Example call
{
  "name": "start_session",
  "arguments": {
    "firstMessage": "Help me refactor the auth module"
  }
}

// Response
{
  "sessionId": "sess_abc123",
  "systemPromptAddition": "## User Context\n- Prefers TypeScript...",
  "injectedMemories": [...],
  "tokensInjected": 142,
  "criticalCount": 3,
  "highCount": 5
}

{
  "name": "build_context",
  "arguments": {
    "lastUserMessage": "What database are we using?",
    "maxRelevant": 10
  }
}

{
  "name": "record_turn",
  "arguments": {
    "sessionId": "sess_abc123",
    "messages": [
      {"role": "user", "content": "What database are we using?"},
      {"role": "assistant", "content": "The project uses PostgreSQL with Drizzle ORM."}
    ]
  }
}

{
  "name": "end_session",
  "arguments": {
    "sessionId": "sess_abc123",
    "outcome": "success",
    "feedback": "Refactored auth module to use JWT"
  }
}

{
  "name": "remember",
  "arguments": {
    "text": "User prefers Tailwind CSS over styled-components",
    "title": "CSS framework preference"
  }
}

{
  "name": "recall",
  "arguments": {
    "message": "What testing framework does this project use?"
  }
}

{
  "name": "search",
  "arguments": {
    "query": "database migrations",
    "limit": 5,
    "since": "2026-01-01T00:00:00Z"
  }
}

{
  "name": "record_trace",
  "arguments": {
    "problem": "Connection pool exhaustion in Turso client",
    "reasoning": "Noticed connections weren't being released after query timeouts",
    "solution": "Added explicit connection.close() in finally block and set maxConnections to 10",
    "outcome": "success",
    "technologies": ["turso", "drizzle", "typescript"],
    "filesModified": ["src/db/client.ts", "src/db/config.ts"]
  }
}

{
  "name": "get_cognitive_context",
  "arguments": {
    "problem": "Set up database migrations with Drizzle ORM",
    "technologies": ["drizzle", "postgresql", "typescript"]
  }
}

// Response summary
{
  "applicationId": "app_xyz",
  "summary": "## Past Similar Problems\n- ✓ Set up Drizzle with Turso → Used drizzle-kit generate...\n\n## Learned Patterns\n- [database] Always run generate before migrate (85% confidence)\n\n## Synthesized Skills\n- Drizzle Migration Setup: Step-by-step for new projects (92% success)",
  "raw": { "traceCount": 3, "patternCount": 1, "skillCount": 1, "hasWorkflow": true }
}

{
  "name": "get_skill_detail",
  "arguments": {
    "skillId": "skill_drizzle_migration_setup",
    "section": "full"
  }
}

{
  "name": "create_skill",
  "arguments": {
    "name": "Fix Turso connection pool exhaustion",
    "description": "Resolve connection leaks when queries timeout in Turso/Drizzle",
    "whenToUse": "Seeing 'too many connections' errors with Turso after running for a while",
    "procedure": [
      "Check for missing connection.close() calls in catch/finally blocks",
      "Add explicit cleanup in a finally block after every query",
      "Set maxConnections to 10 in the Turso client config",
      "Add a connection timeout of 30s",
      "Verify with: SELECT count(*) FROM pg_stat_activity"
    ],
    "pitfalls": [
      "Don't increase maxConnections above 20 — Turso has a hard limit",
      "connection.release() doesn't work — must use connection.close()"
    ],
    "verification": "Run the app under load for 10 minutes, check pg_stat_activity stays under limit",
    "technologies": ["turso", "drizzle", "typescript"],
    "category": "debugging"
  }
}

{
  "name": "submit_feedback",
  "arguments": {
    "patternId": "pat_conn_pool",
    "traceId": "trace_abc123",
    "outcome": "success",
    "notes": "The connection.close() fix resolved the issue immediately"
  }
}