MCP Tools Reference

The main context optimization tool. Returns the most relevant documentation sections for a query, respecting your token budget.

Parameters

Response Format

{
  "sections": [
    {
      "title": "Authentication Flow",
      "content": "...",
      "file": "docs/auth.md",
      "lines": [45, 120],
      "relevance_score": 0.94,
      "token_count": 1200
    }
  ],
  "total_tokens": 3800,
  "suggestions": ["Also check: docs/security.md"]
}

Example

// Query example
{
  "query": "How does user authentication work?",
  "max_tokens": 4000,
  "search_mode": "hybrid"
}

Break a complex query into sub-queries with an execution plan. Your LLM can then call rlm_multi_query to get context for each sub-query.

Parameters

Response Format

{
  "original_query": "Explain the full authentication system",
  "subqueries": [
    "How does login flow work?",
    "How are JWT tokens generated?",
    "How are sessions managed?",
    "How does logout work?"
  ],
  "execution_plan": "sequential",
  "estimated_tokens": 12000
}

Execute multiple queries in a single call with per-query token budgets. Efficient for parallel context retrieval.

Parameters

Response Format

{
  "results": [
    {
      "query": "How does login flow work?",
      "sections": [...],
      "token_count": 1800
    },
    {
      "query": "How are JWT tokens generated?",
      "sections": [...],
      "token_count": 1500
    }
  ],
  "total_tokens": 6500
}

Generate a full execution plan for complex questions, including query decomposition, dependencies, and optimal execution order.

Parameters

Response Format

{
  "plan": {
    "steps": [
      { "id": 1, "query": "...", "depends_on": [] },
      { "id": 2, "query": "...", "depends_on": [1] }
    ],
    "parallel_groups": [[1, 2], [3]],
    "estimated_tokens": 15000
  }
}

Legacy query tool using keyword search. Use rlm_context_query instead for better results.

Parameters

Response Format

{
  "content": "Relevant documentation content...",
  "sources": ["docs/guide.md:45-120"]
}

Search documentation using regex patterns. Useful for finding specific function names, configuration keys, or code patterns.

Parameters

Response Format

{
  "matches": [
    {
      "file": "docs/config.md",
      "line": 45,
      "content": "API_KEY=your-key-here",
      "context": "..."
    }
  ],
  "total_matches": 15
}

Inject session context that persists across queries. Useful for setting task-specific focus areas.

Parameters

Response Format

{
  "success": true,
  "context": "Task: Fix authentication bug. Focus: auth.ts, middleware.ts"
}

Show the current session context. Useful for checking what context is active.

Parameters

Response Format

{
  "context": "Task: Fix authentication bug. Focus: auth.ts, middleware.ts",
  "injected_at": "2024-01-15T10:30:00Z"
}

Clear the session context. Use when switching tasks.

Parameters

Response Format

{
  "success": true,
  "message": "Session context cleared"
}

Get statistics about the indexed documentation.

Parameters

Response Format

{
  "total_documents": 42,
  "total_sections": 156,
  "total_tokens": 125000,
  "last_updated": "2024-01-15T10:30:00Z"
}

List all documentation sections. Useful for understanding what topics are covered.

Parameters

Response Format

{
  "sections": [
    { "id": "auth-overview", "title": "Authentication Overview", "file": "docs/auth.md" },
    { "id": "api-keys", "title": "API Keys", "file": "docs/auth.md" }
  ]
}

Read specific line ranges from documentation. Useful after searching to get full context.

Parameters

Response Format

{
  "content": "Full content of lines 100-150...",
  "file": "docs/auth.md",
  "lines": [100, 150]
}