audigeo-mcp

MCP server exposing the AudiGEO.ai GEO platform to MCP-compatible agents (Claude Code, Claude Desktop, and any other MCP host).

Talks to the existing AudiGEO REST API at https://audigeo.ai/api/v1 using an organization-level API key sent as Authorization: Bearer <key>. Requires plan Pro or Agency.

What's exposed (v0.1.1)

26 tools across 8 modules, 3 resources, and 3 prompt templates. All tool names are prefixed audigeo_ so they don't collide with tools from other MCP servers a host might have mounted.

Resources (URI-addressable, read-only): audigeo://audits/{audit_id}, audigeo://monitoring/results/{site_id}, audigeo://reports/{report_id}.

Prompts: geo_audit_briefing, monitoring_weekly_recap, hallucination_response_draft — all fr/en/es.

Set AUDIGEO_READ_ONLY=true to disable every write tool at startup.

Configuration

Use from Claude Desktop

Install the AudiGEO .mcpb bundle (downloadable from Settings → Intégrations Claude on audigeo.ai). Claude Desktop will prompt for your API key on install — no manual config, no Python prerequisite (the bundle provisions its own environment on first launch).

Use from Claude Code

Two ways to install, from most to least automated:

Via the Sponge Theory marketplace:

/plugin marketplace add ezeeFlop/audigeo
/plugin install audigeo@sponge-theory

Manually, from the downloaded audigeo-claude-code-<version>.tar.gz (Settings → Intégrations Claude on audigeo.ai):

mkdir -p ~/.claude/plugins
tar -xzf audigeo-claude-code-*.tar.gz -C ~/.claude/plugins/

Either way, the plugin's .mcp.json launches the server via uvx audigeo-mcp — uv must be installed (https://docs.astral.sh/uv/getting-started/installation/). uvx fetches the published audigeo-mcp package from PyPI and caches an isolated environment on first launch — no manual pip install.

Set your key once, then restart Claude Code:

export AUDIGEO_API_KEY=agk_...

Use from any other MCP host

The server speaks MCP over stdio. Point your host at:

AUDIGEO_API_KEY=agk_... audigeo-mcp

Development

cd mcp
uv pip install -e ".[dev]"
pytest -q
ruff check .

Smoke test against a local AudiGEO dev server:

export AUDIGEO_API_KEY=agk_test_$(openssl rand -hex 8)
export AUDIGEO_API_URL=http://localhost:8000/api/v1
audigeo-mcp  # then send MCP frames over stdin

Build all three distributable artifacts (wheel, .mcpb, Claude Code plugin):

./build/build_wheel.sh
./build/build_mcpb.sh
./build/build_plugin.sh

License

Sponge Theory proprietary. Distribution restricted to AudiGEO subscribers.