MCP Tools Reference

Indexed exposes two tools via the Model Context Protocol. This page documents their parameters and response format.

`search`

Search across all collections.

Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Natural language search query

Example Call

{
  "tool": "search",
  "arguments": {
    "query": "how to handle authentication timeouts"
  }
}

Response

Returns the top matching chunks across all collections, ranked by relevance score.

{
  "results": [
    {
      "collection": "eng-tickets",
      "document": "ENG-1847",
      "chunk": "Users are experiencing session drops when the SSO refresh token expires...",
      "score": 0.84,
      "metadata": {
        "title": "SSO refresh token expiration handling",
        "source": "https://company.atlassian.net/browse/ENG-1847"
      }
    },
    {
      "collection": "team-wiki",
      "document": "Authentication Guide",
      "chunk": "If a user reports login timeout issues, first check the IdP status...",
      "score": 0.78,
      "metadata": {
        "title": "Authentication Guide",
        "source": "https://company.atlassian.net/wiki/spaces/ENG/pages/12345"
      }
    }
  ]
}

`search_collection`

Search a specific collection.

Parameters

Parameter	Type	Required	Description
`collection`	string	Yes	Name of the collection to search
`query`	string	Yes	Natural language search query

Example Call

{
  "tool": "search_collection",
  "arguments": {
    "collection": "eng-tickets",
    "query": "rate limiting implementation"
  }
}

Response

Same format as search, but results come only from the specified collection.

Server Configuration

Transports

Transport	Command	Use case
stdio (default)	`indexed mcp run`	Claude Desktop, Cursor, Cline
HTTP	`indexed mcp run --transport http --port 8000`	Docker, remote access
SSE	`indexed mcp run --transport sse`	Server-Sent Events streaming
Streamable HTTP	`indexed mcp run --transport streamable-http`	Newer HTTP streaming

MCP Inspector

For debugging, use the development mode with the built-in MCP Inspector:

indexed mcp dev

This launches a web UI where you can test tool calls interactively.

Client Configuration

See the setup guides for specific clients:

MCP Tools Reference

On this page