Setup MCP in 2 Minutes

Choose Docker or Python, paste one JSON config, restart your client. Works on macOS, Linux, and Windows. No account. No API keys for core tools.

1

Install Docker

Skip this step if Docker is already installed. Run docker --version to check.

bash
# macOS — install Docker Desktop
# Download from https://www.docker.com/products/docker-desktop/
# Or via Homebrew:
brew install --cask docker

# Linux (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sh

# Verify
docker --version
2

Pull the Docker image

One command fetches the latest image. No Python required on your machine.

bash
docker pull agenticstore/agentic-store-mcp:latest

# Verify — lists all available tools
docker run --rm agenticstore/agentic-store-mcp:latest --list
[tip]
Already have the image? Skip to Step 3. Run docker pull agenticstore/agentic-store-mcp:latest anytime to update.
3

Enable web search optional

agentic_web_search requires SearXNG — a free, self-hosted search engine. Skip this step if you only need web crawling and code tools.

bash
# Create a docker-compose.yml file somewhere
# Download it from the repo (or run curl)
curl -O https://raw.githubusercontent.com/agenticstore/agentic-store-mcp/main/docker-compose.yml

# Start SearXNG
docker compose up -d searxng

SearXNG runs at http://localhost:8080 — the MCP server connects to it automatically when you use the web search config below.

4

Connect your AI client

Pick the config that matches your setup. Paste it into your client's JSON file and restart.

Without web search

claude_desktop_config.json
{
  "mcpServers": {
    "agenticstore": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "agenticstore/agentic-store-mcp:latest"]
    }
  }
}

With web search (requires docker compose up -d)

claude_desktop_config.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"
      ]
    }
  }
}

Full setup at Client Setup →

5

Verify it's working

Ask your AI assistant to list available tools. You should see all five tools.

prompt to your AI

"List all available MCP tools"

expected response includes

python_lint_checker
repo_scanner
dependency_audit
agentic_web_crawl
agentic_web_search

Note: agentic_web_search appears only if SearXNG is running.

⚠

Seeing "MCP agenticstore: Server disconnected"? See the troubleshooting guide →

What's next

Tool reference →

See what each tool does and how to use it

Client setup →

Full configs for Claude Desktop, Cursor, Windsurf, VS Code

Troubleshooting →

Server disconnected, missing tools, config errors

PyPI →

Install via PyPI package

Install globally via pip or uv

If you prefer to have the module installed globally instead of using ephemeral environments:

bash
# Install via uv (recommended)
uv tool install agentic-store-mcp

# Or install via pip
pip install agentic-store-mcp --upgrade

# Start the server
agentic-store-mcp

# Or start the UI dashboard
agentic-store-webapp

Then point your client config to the executable:

claude_desktop_config.json
{
  "mcpServers": {
    "agenticstore": {
      "command": "agentic-store-mcp",
      "args": []
    }
  }
}

Installation FAQ