MCP Tools Reference

await th0th_index({
  projectPath: "/home/user/my-project",
  projectId: "my-project",
  forceReindex: false,
  warmCache: true
});

// Response:
// {
//   "jobId": "job_abc123",
//   "projectId": "my-project",
//   "projectPath": "/home/user/my-project",
//   "status": "started",
//   "message": "Indexing started in background. Use th0th_index_status(jobId) to check progress."
// }

// After indexing starts
const indexResult = await th0th_index({
  projectPath: "/home/user/my-project"
});

// Check status
const status = await th0th_index_status({
  jobId: indexResult.jobId
});

// Response:
// {
//   "jobId": "job_abc123",
//   "status": "completed",
//   "progress": {
//     "filesProcessed": 1543,
//     "totalFiles": 1543,
//     "percentComplete": 100
//   },
//   "projectId": "my-project"
// }

await th0th_search({
  query: "authentication middleware",
  projectId: "my-project",
  maxResults: 5,
  responseMode: "summary",
  include: ["src/**/*.ts"],
  exclude: ["**/*.test.ts"]
});

// Returns:
// - Top 5 results matching "authentication middleware"
// - Summary mode (no full content, saves 70% tokens)
// - Only TypeScript files in src/
// - Excludes test files

await th0th_remember({
  content: "User prefers TypeScript over JavaScript for new components",
  type: "preference",
  userId: "user_123",
  projectId: "my-project",
  importance: 0.8,
  tags: ["typescript", "preferences"],
  format: "toon"
});

// Stores preference in SQLite
// Returns memory ID and metadata in TOON format

await th0th_recall({
  query: "typescript preferences",
  userId: "user_123",
  projectId: "my-project",
  types: ["preference", "decision"],
  limit: 5,
  format: "toon"
});

// Returns:
// - Top 5 memories matching "typescript preferences"
// - Filtered to preference and decision types
// - TOON format (70% smaller than JSON)

await th0th_optimized_context({
  query: "authentication implementation",
  projectId: "my-project",
  maxTokens: 4000,
  maxResults: 5
});

// Returns:
// - Top 5 relevant files about authentication
// - Compressed to fit within 4000 tokens
// - Ready to use as AI context
// - Metadata: sources, token savings, compression ratio

// Get overall summary
await th0th_analytics({ type: "summary" });

// Get project-specific stats
await th0th_analytics({ 
  type: "project",
  projectId: "my-project",
  limit: 10
});

// Get cache performance
await th0th_analytics({ 
  type: "cache",
  projectId: "my-project"
});

// Get recent searches
await th0th_analytics({ 
  type: "recent",
  limit: 50
});

{
  "success": true,
  "data": { ... },
  "metadata": { ... }
}

# Memory
  id: mem_abc123
  content: User prefers TypeScript
  type: preference
  importance: 0.8
  tags:
    - typescript
    - preferences
  createdAt: 2026-03-09T10:30:00Z

{
  "success": false,
  "error": "Error message here"
}