MCP Server

PingAura exposes a remote MCP server that lets AI assistants query your account data — domains, visibility scores, site audits, articles, and more — without leaving the editor or chat interface.

Authentication

All requests require an API key generated from your team settings.

1. Go to Settings > API Keys in your PingAura dashboard.
2. Click Create API Key, give it a name, and copy the key.
3. The key is shown once. Store it securely.

Key format: pa_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY

Use it in the Authorization header as either:

• Authorization: Key pa_xxx_yyy
• Authorization: Bearer pa_xxx_yyy

Only account owners can create and revoke keys. Team members can view existing keys.

Quick start

The fastest way to connect is with Claude Code:

claude mcp add pingaura --transport http https://www.pingaura.ai/api/mcp \
  --header "Authorization: Key YOUR_API_KEY"

Then ask Claude something like: "List my domains and their visibility scores"

Client setup

Claude Code (CLI)

claude mcp add pingaura --transport http https://www.pingaura.ai/api/mcp \
  --header "Authorization: Key YOUR_API_KEY"

Verify with:

claude mcp list

No restart required.

Claude Desktop

Edit the config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pingaura": {
      "url": "https://www.pingaura.ai/api/mcp",
      "headers": {
        "Authorization": "Key YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "pingaura": {
      "url": "https://www.pingaura.ai/api/mcp",
      "headers": {
        "Authorization": "Key YOUR_API_KEY"
      }
    }
  }
}

Or go to Settings > Cursor Settings > MCP and add the server there. No restart required.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "pingaura-api-key",
      "description": "PingAura API Key",
      "password": true
    }
  ],
  "servers": {
    "pingaura": {
      "type": "http",
      "url": "https://www.pingaura.ai/api/mcp",
      "headers": {
        "Authorization": "Key ${input:pingaura-api-key}"
      }
    }
  }
}

VS Code will prompt you for the API key on first use.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pingaura": {
      "serverUrl": "https://www.pingaura.ai/api/mcp",
      "headers": {
        "Authorization": "Key YOUR_API_KEY"
      }
    }
  }
}

Note: Windsurf uses serverUrl instead of url.

Amazon Q Developer

Add to ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "pingaura": {
      "type": "http",
      "url": "https://www.pingaura.ai/api/mcp",
      "headers": {
        "Authorization": "Key YOUR_API_KEY"
      }
    }
  }
}

ChatGPT

MCP support in ChatGPT is currently in beta and uses OAuth authentication. Contact us at [email protected] for setup assistance.

Available tools

Once connected, your AI assistant has access to these tools:

Example prompts

Once PingAura is connected, try asking your AI assistant:

• "Show me all my domains and their current status"
• "What's the latest visibility score for example.com?"
• "List the critical audit issues for my homepage"
• "Show me all published articles and their word counts"
• "Compare my visibility scores against competitors"
• "Which pages have the most visitors?"
• "Get the AEO issues from the latest audit"

Access control

• API keys are scoped to a team account — all data returned is isolated to that account.
• Only account owners can create, update, or revoke API keys.
• Team members can view existing keys but cannot manage them.
• Keys support optional expiration dates.
• Revoked keys are immediately rejected.

Troubleshooting

"Unauthorized" error

• Check that your API key is correct and not revoked.
• Ensure the header format is Authorization: Key pa_xxx_yyy or Authorization: Bearer pa_xxx_yyy.

Tools not showing up

• Run claude mcp list (Claude Code) or check MCP status in your client.
• Verify the URL is exactly https://www.pingaura.ai/api/mcp.

Connection timeout

• The MCP server is stateless — each request is independent. If you're behind a firewall, ensure outbound HTTPS to www.pingaura.ai is allowed.