voygr-mcp

voygr-mcp

MCP server for VOYGR place verification and outbound venue calls.Proper stdio MCP: tools, resources, prompts, progress notifications, and elicitation.

Demo Video

Install

cd voygr-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Requires a VOYGR API key at process start:

export VOYGR_API_KEY=your_key
# or: voygr login your_key

Dry-run (default)

VOYGR_DRY_RUN defaults to 1. Calls only are mocked (magic numbers, scriptedevents, canned transcripts). verify_place / verify_places / check_creditsalways hit the live VOYGR API via the official voygr Python client.

Live dialing:

export VOYGR_DRY_RUN=0
docker compose up -d redis   # call state / event cursors
export VOYGR_REDIS_URL=redis://localhost:6379/0
voygr-mcp

Claude Desktop (stdio)

1. Put VOYGR_API_KEY=... in the project .env (loaded automatically; Claude’scwd does not matter).
2. Edit ~/Library/Application Support/Claude/claude_desktop_config.json(macOS) and merge:

{
  "mcpServers": {
    "voygr": {
      "command": "/Users/vaarunsinha/voygr-mcp/scripts/claude-desktop-mcp.sh",
      "env": {
        "VOYGR_DRY_RUN": "1"
      }
    }
  }
}

3. Fully quit and reopen Claude Desktop. Confirm under + → Connectors (orDeveloper settings) that voygr is connected and tools like verify_placeappear.

Or point command at .venv/bin/voygr-mcp directly — the server also loadsthe package-root .env on start.

Tools

Consent is never a tool parameter — it is always an elicitation to the human.

Resources / prompt

• voygr://call/{id}/transcript — 7-day retention noted in metadata
• voygr://call/{id}/events
• Prompt: verify_before_recommending

Honesty (demo / video)

When recording the 60s demo:

• Refusal arm (verify_places dropping closed/not_found) should be live API.
• Mid-call handoff segment should be dry-run (+1-555-0102) and labeled on screen.
• List which segments used dry-run in any public write-up.

Tests

pytest

Tests use ScriptedElicitationProvider (no human). No skip-consent env var shipsin the server.

Stack

Python, official mcp SDK (stdio), voygr PyPI client, httpx (calls API), Redis(live call state), Docker Compose, pytest. No FastAPI in v1.

Reference checkout of upstream CLI (not vendored): ../voygr-dev-tools.