Client Setup
Connect AgenticStore MCP Tools to your AI client. Pick your install method below — Docker or Python (uv) — then copy the config for your client and restart.
[tip]
All clients use the same JSON config structure. Only the file path differs per client. After editing the config, fully restart the client (Cmd+Q on macOS, not just close the window).
Claude Desktop
macOS/Linux
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows
%APPDATA%\Claude\claude_desktop_config.jsonWithout web search
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--network", "agentic-store-mcp_default",
"-e", "SEARXNG_URL=http://searxng:8080",
"agenticstore/agentic-store-mcp:latest"
]
}
}
}Cursor
macOS/Linux
~/.cursor/mcp.jsonWindows
%USERPROFILE%\.cursor\mcp.jsonWithout web search
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--network", "agentic-store-mcp_default",
"-e", "SEARXNG_URL=http://searxng:8080",
"agenticstore/agentic-store-mcp:latest"
]
}
}
}Windsurf
macOS/Linux
~/.codeium/windsurf/mcp_config.jsonWindows
%USERPROFILE%\.codeium\windsurf\mcp_config.jsonWithout web search
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--network", "agentic-store-mcp_default",
"-e", "SEARXNG_URL=http://searxng:8080",
"agenticstore/agentic-store-mcp:latest"
]
}
}
}VS Code (MCP extension)
macOS/Linux
.vscode/mcp.json (workspace) or settings.jsonWindows
.vscode\mcp.json (workspace) or settings.jsonWithout web search
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
json
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--network", "agentic-store-mcp_default",
"-e", "SEARXNG_URL=http://searxng:8080",
"agenticstore/agentic-store-mcp:latest"
]
}
}
}Selecting modules
Load all tools, a specific module, or individual tools by changing the args array.
All tools (default)
json
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]AgenticCode only — lint, scan, audit
json
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest", "--modules", "code"]AgenticData only — web crawl + web search
json
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest", "--modules", "data"]Single tool
json
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest", "--tools", "agentic_web_crawl"]Keeping the image up to date
Run this anytime to pull the latest tools and fixes. Your client config never changes.
bash
docker pull agenticstore/agentic-store-mcp:latest[tip]
Need a specific version? Use a pinned tag instead:
agenticstore/agentic-store-mcp:0.4.0