Instalar extensión
ES EN

Connect Impactube with your AI client

Impactube MCP is a token-gated, read-only connector for ChatGPT, Claude, Gemini CLI, VS Code, Cursor and compatible agents. It requires an active Impactube Plus account.

Overview

  • Main endpoint: https://impactube.com/mcp
  • Transport: Streamable HTTP.
  • Authentication: OAuth or Bearer personal MCP token.
  • Scope: impactube.mcp.read
  • Tools: 17 read-only tools.
  • SSE fallback: not enabled in this phase.

Endpoint

Use https://impactube.com/mcp as the primary MCP endpoint. https://impactube.com/mcp/ is supported as an equivalent URL. https://impactube.com/mcp/index.php is legacy compatibility only and is not the primary endpoint.

Security / read-only

  • The connector does not modify Impactube data.
  • It does not run Risk Score.
  • It does not buy or consume credits.
  • It does not call external APIs during MCP tool calls.
  • It reads cached Impactube analytics only, so some data can lag behind live YouTube.
  • If your Plus plan stops being active, OAuth and personal MCP tokens stop working.

ChatGPT

  1. Open ChatGPT connector settings and add the Impactube MCP URL: https://impactube.com/mcp.
  2. Sign in with your Impactube account when the OAuth window opens.
  3. Approve read-only access. ChatGPT should then discover 17 Impactube tools.

If your Plus plan is not active, the OAuth screen will show a Plus-required message and ChatGPT will not receive a token.

Claude

  1. Use a Remote MCP custom connector with URL https://impactube.com/mcp.
  2. If Claude completes Dynamic Client Registration, leave Advanced settings empty.
  3. If Claude asks for OAuth Client ID, use https://impactube.com/oauth/clients/claude-custom-connector.

Accepted Claude redirect URIs:

  • https://claude.ai/api/mcp/auth_callback
  • https://claude.com/api/mcp/auth_callback

No client secret is required; Claude should use PKCE as a public client.

Claude API

Use a URL MCP server with a personal MCP token. Example without a real token:

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://impactube.com/mcp",
      "name": "impactube",
      "authorization_token": "YOUR_IMPACTUBE_MCP_TOKEN"
    }
  ]
}

Gemini CLI

{
  "mcpServers": {
    "impactube": {
      "httpUrl": "https://impactube.com/mcp",
      "headers": {
        "Authorization": "Bearer $IMPACTUBE_MCP_TOKEN"
      },
      "timeout": 30000,
      "trust": false
    }
  }
}

VS Code / GitHub Copilot

{
  "inputs": [
    {
      "type": "promptString",
      "id": "impactube-mcp-token",
      "description": "Impactube MCP Token",
      "password": true
    }
  ],
  "servers": {
    "impactube": {
      "type": "http",
      "url": "https://impactube.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:impactube-mcp-token}"
      }
    }
  }
}

Cursor

Add a remote MCP server with endpoint https://impactube.com/mcp. Use OAuth if supported or a personal MCP token. Status: pending manual validation.

Other MCP clients

Use Streamable HTTP at https://impactube.com/mcp. Authenticate with OAuth or Authorization: Bearer YOUR_IMPACTUBE_MCP_TOKEN. The only personal-token scope is impactube.mcp.read.

Personal MCP tokens

Active Plus users can create personal read-only MCP tokens from Integraciones IA. Impactube stores only a hash. The full token is shown once when created.

Troubleshooting

  • 401: missing or expired OAuth/Bearer token.
  • 403 plus_required: Plus is not active or the token was issued for a user who is no longer eligible.
  • 429: rate limit reached.
  • SSE fallback not enabled: use Streamable HTTP.

Available tools

  • Check MCP data readiness and available cached datasets.
  • Find cached opportunity candidates.
  • Read cached video and channel context.
  • Find metadata-based similar channels and competitors.
  • Read cached niche opportunities and revenue estimate ranges.
  • Search cached channels, videos, niches and new fast-growing channels.

Example prompts

  • Dame 10 canales nuevos de menos de 90 dias y mas de 3.000 suscriptores.
  • Busca oportunidades reales en el nicho de historia en espanol.
  • Analiza este video y dime si es oportunidad accionable o solo senal de demanda: VIDEO_ID
  • Dime que datasets puede consultar Impactube.
  • Encuentra videos con outlier score alto en canales pequenos.
  • Busca canales similares a este canal: CHANNEL_ID
  • Dame oportunidades con buena senal viral pero que necesiten validacion manual.

Disconnect

You can disconnect OAuth apps from the client settings. Plus users can revoke personal MCP tokens from the Integraciones IA page.