AskBadge MCP Server

AskBadge MCP is a local Model Context Protocol server that lets AI assistants read data from an AskBadge Agency account through the public v1 API.

What it supports

• list_sites
• get_site
• get_analytics
• get_loop_data
• get_widget_config

The server is read-only. It does not create, update, or delete sites.

Requirements

• Node.js 20+
• An AskBadge Agency API key

Local development

From the repo root:

cd mcp
pnpm install --ignore-workspace
pnpm build

Run it with:

ASKBADGE_API_KEY=sk_live_your_key_here node dist/index.js

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "askbadge": {
      "command": "npx",
      "args": ["-y", "@askbadge/mcp"],
      "env": {
        "ASKBADGE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

Add this to .cursor/mcp.json:

{
  "mcpServers": {
    "askbadge": {
      "command": "npx",
      "args": ["-y", "@askbadge/mcp"],
      "env": {
        "ASKBADGE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}