@refreshagent/mcp

Refresh Agent MCP

Connect Claude Code to Refresh Agent without exposing Google setup details.

claude mcp add refreshagent npx -y @refreshagent/mcp --key=ra_live_...

The bridge reads --key, REFRESHAGENT_API_KEY, or ~/.config/refreshagent/.env, and proxies Claude tool calls to the Refresh Agent API.

The live-search-console-data skill can create that local config file automatically through the browser login flow.

For clients that accept an MCP JSON configuration:

{
  "mcpServers": {
    "refreshagent": {
      "command": "npx",
      "args": ["-y", "@refreshagent/mcp"],
      "env": { "REFRESHAGENT_API_KEY": "YOUR_REFRESHAGENT_API_KEY" }
    }
  }
}

Requires Node.js 18 or newer and a RefreshAgent account with Google data connected. Tools: list_connected_sites, check_website_traffic, get_keyword_rankings. Pricing and data-access limits: https://refreshagent.com/plans.