MCP Clients¶

agentgrep exposes a local stdio MCP server. Any MCP client that can launch a command can run it.

Codex CLI¶

From a development checkout:

[mcp_servers.agentgrep]
command = "uv"
args = ["run", "agentgrep-mcp"]
cwd = "/path/to/agentgrep"

For an installed package:

[mcp_servers.agentgrep]
command = "agentgrep-mcp"

From a development checkout:

$ claude mcp add agentgrep --cwd /path/to/agentgrep -- uv run agentgrep-mcp

For an installed package:

$ claude mcp add agentgrep -- agentgrep-mcp

Use a JSON mcpServers entry:

{
  "mcpServers": {
    "agentgrep": {
      "command": "uv",
      "args": ["run", "agentgrep-mcp"],
      "cwd": "/path/to/agentgrep"
    }
  }
}

For an installed package:

{
  "mcpServers": {
    "agentgrep": {
      "command": "agentgrep-mcp"
    }
  }
}

The repository includes fastmcp.json:

$ uv run fastmcp run fastmcp.json

Inspect the server surface:

$ uv run fastmcp inspect fastmcp.json