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.
GPT / OpenAI Codex
Install the Codex CLI, then open the local AgenticStore dashboard. In MCP Hub → Clients, select GPT / OpenAI Codex, choose your tools, and click Apply. AgenticStore updates ~/.codex/config.toml while preserving your other settings. Restart Codex to load the tools.
MCP tool setup does not route model prompts through the firewall. To inspect Codex traffic, start the TLS proxy in Firewall, connect GPT / Codex (ChatGPT login), restart Codex, and verify a fresh recording. OpenAI SDK apps have a separate firewall connection. See firewall setup →
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonWithout web search
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
{
"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
~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.jsonWithout web search
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
{
"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
~/.codeium/windsurf/mcp_config.json%USERPROFILE%\.codeium\windsurf\mcp_config.jsonWithout web search
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
{
"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)
.vscode/mcp.json (workspace) or settings.json.vscode\mcp.json (workspace) or settings.jsonWithout web search
{
"mcpServers": {
"agenticstore": {
"command": "docker",
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
}
}
}With web search (requires docker compose up -d)
{
"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)
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]AgenticCode only — lint, scan, audit
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest", "--modules", "code"]AgenticData only — web crawl + web search
"args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest", "--modules", "data"]Single tool
"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.
docker pull agenticstore/agentic-store-mcp:latestagenticstore/agentic-store-mcp:0.4.0