TG Market

npx add-mcp 'https://tgmarket.io/mcp'

Conecta TG Market a Claude, Cursor, VS Code y otros asistentes que admitan el Protocolo de Contexto de Modelo (MCP). El asistente busca canales, lee tarjetas y métricas, busca publicaciones y calcula precios de exportación por ti, con tu clave de API y los mismos precios que la API REST.

URL del servidor (transporte: Streamable HTTP):

https://tgmarket.io/mcp

Autorización. Las cuentas gratuitas con correo electrónico verificado se conectan mediante OAuth (ver más abajo): una prueba de 20 llamadas al día, sin contactos de anuncios, profundidad de búsqueda gratuita. En los planes de pago, las llamadas consumen créditos. Una clave de API en el encabezado Authorization: Bearer requiere un plan de pago; sin una clave válida o inicio de sesión OAuth, el servidor devuelve 401. Crea una clave en API keys

claude.ai y ChatGPT se conectan sin clave, mediante OAuth: inicias sesión en TG Market y permites el acceso.

Conectar

claude.ai y ChatGPT (conectores, OAuth)

• claude.ai: Configuración → Conectores → Añadir conector personalizado, URL https://tgmarket.io/mcp. Haz clic en Conectar, inicia sesión en TG Market y haz clic en Permitir.
• ChatGPT (modo desarrollador): Configuración → Apps y conectores → Crear, URL https://tgmarket.io/mcp, autenticación OAuth. Inicia sesión en TG Market y haz clic en Permitir.

No se necesita clave de API: el acceso se otorga a la aplicación específica y se cobra como una clave de API. En el plan gratuito funciona como prueba: unas pocas solicitudes al día con resultados limitados. El acceso dura hasta 180 días y se puede revocar en cualquier momento en Panel → Claves de API → Aplicaciones conectadas.

Claude Code

claude mcp add --transport http tgmarket https://tgmarket.io/mcp \
  --header "Authorization: Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx"

Cursor (~/.cursor/mcp.json o .cursor/mcp.json en el proyecto)

{
  "mcpServers": {
    "tgmarket": {
      "url": "https://tgmarket.io/mcp",
      "headers": { "Authorization": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "tgmarket": {
      "type": "http",
      "url": "https://tgmarket.io/mcp",
      "headers": { "Authorization": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

Claude Desktop y clientes sin encabezados personalizados — mediante el puente mcp-remote

{
  "mcpServers": {
    "tgmarket": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tgmarket.io/mcp", "--header", "Authorization:${MK_AUTH}"],
      "env": { "MK_AUTH": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

Cualquier otro cliente: transporte Streamable HTTP, la URL anterior, encabezado Authorization: Bearer <key>.

Mantén la clave en secreto: todo lo que solicite el asistente se carga a tu saldo. Crea una clave separada para el asistente para que puedas revocarla de forma independiente.

Herramientas

Herramienta	Qué hace	Costo
search_channels	Busca canales por texto y filtros (idioma, categorías, suscriptores, ER, crecimiento, anuncios…), hasta 100 por página con un cursor	solicitud + filas
count_channels	Cuenta canales coincidentes, audiencia total y facetas por idioma, categoría y tamaño	solicitud
get_channel	Tarjeta de canal por nombre de usuario o ID: campos base, métricas, contactos de anuncios	solicitud + fila
get_channel_history	Suscriptores diarios, vistas, ER y alcance	solicitud + historial
get_channel_posts	Publicaciones recientes de un canal	solicitud + publicaciones
search_posts	Búsqueda de texto completo en publicaciones con filtros de canal	solicitud + publicaciones
keyword_trend	Menciones de palabras clave a lo largo del tiempo: publicaciones, canales y vistas por día o semana	solicitud + 0.01 por punto
quote_export	Precio de exportación antes de pedir: filas, filas gratuitas, descuentos, total	solicitud
list_categories	Árbol de categorías para filtros	gratis
list_languages	Idiomas con recuentos de canales	gratis
get_usage	Saldo, plan, límite de velocidad y uso	gratis

Facturación y límites

• El servidor MCP es un envoltorio delgado sobre la API REST v1: los mismos precios, el mismo límite de velocidad (compartido con solicitudes REST en esta clave) y el mismo límite diario de canales únicos.
• Las filas se cobran según la tarifa del conjunto de campos; un canal que esta clave ya pagó dentro de 30 días es gratuito, tanto en REST como en MCP.
• Cada resultado de herramienta muestra cuántos créditos costó la llamada: credits_charged.
• Las exportaciones no se piden mediante MCP: el asistente solo calcula el precio (quote_export). Haz el pedido en el sitio web o mediante POST /v1/exports.
• Cuando el saldo se agota o se alcanza el límite de velocidad, la herramienta devuelve un error con el mismo código que la API REST (payment_required, rate_limited…).

Ejemplos de solicitudes

• "Encuentra canales de criptomonedas en inglés con 10–100K suscriptores y ER superior al 5%, ordenados por crecimiento en 30 días."
• "Muestra el historial de suscriptores de @durov de los últimos 90 días y compáralo con canales similares."
• "¿Cuánto costaría una exportación de todos los canales de noticias en hindi con métricas?"

Documentación de la API REST →