MCP

Use Repokit through the hosted MCP interface.

Start on repokit.co/mcp for setup guidance. The ranking engine lives behind the Repokit API; mcp.repokit.live is the hosted MCP transport for MCP-capable clients.

Page intent

Use this page as the human-facing MCP overview. Repokit MCP is the first-party MCP interface backed by the Repokit API, while the raw host root and protocol endpoint are only for actual client configuration.

https://mcp.repokit.live/mcpremote HTTP MCP
01

client connects

Initialize against the hosted MCP endpoint and negotiate capabilities.

02

tool call issued

Call find_relevant_files with your repository_id and a real task string.

03

ranked files returned

Receive the same repository-aware shortlist through the MCP tool surface.

04

agent proceeds

Ground planning, answering, or editing in the returned file set.

Grounding rule

Initialize can be unauthenticated. Tool calls should send the same bearer token you issue from a ready repository in the control plane.

Host root

https://mcp.repokit.live

Protocol endpoint

https://mcp.repokit.live/mcp

What this page is for

Repokit MCP exposes repository-aware retrieval as a hosted MCP product for clients that already understand tool-based workflows.

The engine boundary still lives at the Repokit API. This page is the human-facing setup path; the raw hostnames below are technical transport targets, not alternate landing pages.

How MCP relates to the API

  • The Repokit API is the direct engine contract.
  • Repokit MCP is the first-party MCP interface powered by that API.
  • Use the API when you want direct HTTP control.
  • Use MCP when your client already supports remote MCP servers.

Important endpoint distinction

  • repokit.co/mcp is the page readers should start with.
  • mcp.repokit.live is the hosted MCP service root.
  • /mcp is the JSON-RPC protocol endpoint.
  • Initialize can be unauthenticated, but tool calls require bearer auth.

Initialize example

initializebash
curl -sS -X POST \
  -H "Content-Type: application/json" \
  https://mcp.repokit.live/mcp \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "0.1"
      }
    }
  }'

Authenticated tool call

tools/callbash
curl -sS -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_token>" \
  https://mcp.repokit.live/mcp \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "find_relevant_files",
      "arguments": {
        "repository_id": "<repository_id>",
        "query": "fix request validation error in routing",
        "top_k": 3
      }
    }
  }'

What a successful flow looks like

  • Activate a supported repository.
  • Wait until it reaches ready.
  • Issue a verification token.
  • Initialize the hosted MCP endpoint.
  • Call find_relevant_files.

When to use MCP

  • Your client already supports MCP.
  • You want tool-style access instead of wiring raw API requests yourself.
  • You want the same retrieval layer through a first-party MCP transport.