docs/client setup

MCP Tools Setup for Claude, Cursor, Windsurf & VS Code

Add AgenticStore MCP Tools to your AI client. The server communicates over stdio and starts automatically when your client connects. After editing the config, restart the client.

[tip]
All clients use the same JSON config structure — only the file path differs per client.

Claude Desktop

macOS / Linux~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop config
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}

Cursor

macOS / Linux~/.cursor/mcp.json
Windows%USERPROFILE%\.cursor\mcp.json
Cursor config
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}

Windsurf

macOS / Linux~/.codeium/windsurf/mcp_config.json
Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json
Windsurf config
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}

VS Code (MCP extension)

macOS / Linux.vscode/mcp.json (workspace) or settings.json
Windows.vscode\mcp.json (workspace) or settings.json
VS Code (MCP extension) config
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}

Selecting modules

You can load all tools, a specific module, or individual tools by changing the args array.

All tools (default)

json
"args": ["agentic-store-mcp", "--modules", "code,data"]

AgenticCode only — lint, scan, audit

json
"args": ["agentic-store-mcp", "--modules", "code"]

AgenticData only — web search

json
"args": ["agentic-store-mcp", "--modules", "data"]

Single tool

json
"args": ["agentic-store-mcp", "--tools", "agentic_web_search"]

Running from a local clone

If you cloned the repository instead of using uvx, point the config at the local path:

json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/agenticstore-mcp-tools",
        "server.py",
        "--modules", "code,data"
      ]
    }
  }
}

Replace /absolute/path/to/agenticstore-mcp-tools with the actual path to your clone.

Client setup FAQ