Openhandle

Lee perfiles públicos de Instagram, TikTok, X y Reddit, publicaciones, comentarios y métricas a través de MCP. Conéctate con OAuth o una clave de API.

Ver en openhandle.dev

Servidor MCP alojado

npx add-mcp 'https://api.openhandle.dev/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Datos sociales para tu agente. Un servidor, cada endpoint es una herramienta.

Openhandle le da a tu agente acceso a Instagram, TikTok, X y Reddit. Cada endpoint de la API se convierte en una herramienta.

URL del servidor: https://api.openhandle.dev/mcp (HTTP Streamable)

Conectar

Claude

https://api.openhandle.dev/mcp

Añade un conector personalizado. Abre Configuración, luego Conectores, luego Añadir conector personalizado. Pega la URL del servidor.
Aprueba en el navegador. Openhandle se abre en una pestaña y te pide que apruebes la conexión. Elige Test o Live en esa pantalla.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

ChatGPT

https://api.openhandle.dev/mcp

Añade un conector. Abre Configuración, luego Conectores, luego Crear. Pega la URL del servidor y guarda.
Aprueba en el navegador. Openhandle se abre en una pestaña y te pide que apruebes la conexión. Elige Test o Live en esa pantalla.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

Claude Code

claude mcp add --transport http openhandle https://api.openhandle.dev/mcp

Ejecuta un comando. Esto registra el servidor para el proyecto actual.
Inicia sesión una vez. Escribe /mcp en Claude Code y elige openhandle. Tu navegador se abre, apruebas y eliges Test o Live. Las configuraciones sin interfaz gráfica pueden pasar una clave API con --header "Authorization: Bearer $OPENHANDLE_TEST_KEY" en su lugar.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

Cursor

{
  "mcpServers": {
    "openhandle": {
      "url": "https://api.openhandle.dev/mcp"
    }
  }
}

Añade el servidor a mcp.json. Crea o edita .cursor/mcp.json en tu proyecto y pega esto.
Inicia sesión cuando Cursor lo pida. Cursor muestra un aviso de inicio de sesión junto al servidor. Aprueba en el navegador y elige Test o Live.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

VS Code

{
  "servers": {
    "openhandle": {
      "type": "http",
      "url": "https://api.openhandle.dev/mcp"
    }
  }
}

Añade el servidor a mcp.json. Crea o edita .vscode/mcp.json en tu proyecto y pega esto.
Inícialo e inicia sesión. Haz clic en Iniciar sobre la entrada del servidor. VS Code abre el navegador, apruebas y eliges Test o Live.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

Windsurf

{
  "mcpServers": {
    "openhandle": {
      "serverUrl": "https://api.openhandle.dev/mcp"
    }
  }
}

Añade el servidor a mcp_config.json. Abre la configuración de MCP en Windsurf, edita el archivo de configuración y pega esto.
Inicia sesión cuando se te pida. Windsurf abre el navegador para el inicio de sesión. Aprueba y elige Test o Live.
Pide datos sociales. Las herramientas aparecen en el chat. Pide en palabras sencillas y el agente elige la correcta.

Prueba primero este prompt: Encuentra un perfil público de Instagram en los datos de prueba y muéstrame su número de seguidores y sus últimas tres publicaciones.

La pantalla de aprobación crea una clave API con el nombre del cliente, por ejemplo Claude (MCP). Desconecta un cliente en Configuración, servidor MCP en el panel de control. Eso revoca la clave y todos los tokens a la vez.

Herramientas

Plataforma	Herramientas	Ejemplos
Instagram	43	`instagram_get_profile`, `instagram_list_profile_posts`, `instagram_list_post_comments`
TikTok	28	`tiktok_get_profile`, `tiktok_search_posts`, `tiktok_list_trending_posts`
X	15	`twitter_get_profile`, `twitter_list_followers`, `twitter_search_posts`

find_test_data: Encuentra entradas sintéticas estables por plataforma, operación o característica. Sin medir.
get_test_data: Obtén una entrada del catálogo sintético por su ID estable. Sin medir.

Cada resultado lleva los mismos metadatos, para que tu agente pueda decirte cuánto costó una llamada. Campos: environment, requestId, actualCharge, liveEquivalentPrice, datasetVersion.

Cuánto cuesta

Sin recargo por MCP. Una llamada a una herramienta cuesta lo mismo que la llamada REST equivalente. No hay cargo adicional por MCP.
Las respuestas más antiguas cuestan menos. Los aciertos de caché cuestan $0.0005 a las 24 horas y $0.0001 a los 7 días. Un acierto de caché a los 30 días es gratis.
Las solicitudes fallidas son gratis. Los errores del proveedor, nuestros errores, la entrada no válida y los límites de velocidad no cuestan nada.
Test siempre es gratis. Cada herramienta funciona con datos sintéticos en Test. El cargo real siempre es cero.

Tarifas: https://openhandle.dev/pricing.md

Detalles de OAuth

Documento	URL
Metadatos del recurso protegido	`https://api.openhandle.dev/.well-known/oauth-protected-resource/mcp`
Metadatos del servidor de autorización	`https://api.openhandle.dev/.well-known/oauth-authorization-server`
Registro dinámico de clientes	`https://api.openhandle.dev/oauth/register`
Autorización	`https://api.openhandle.dev/oauth/authorize`
Token	`https://api.openhandle.dev/oauth/token`
Revocación	`https://api.openhandle.dev/oauth/revoke`

Tipos de concesión: authorization_code con PKCE (S256), refresh_token
Ámbito: mcp
Token de acceso: Vive durante 1 hora
Token de actualización: Rota en cada uso, vive durante 30 días
Indicador de recurso: resource=https://api.openhandle.dev/mcp

Preguntas frecuentes

¿Funciona con ChatGPT?

Sí. Cualquier cliente que hable MCP remoto sobre HTTP Streamable funciona. Pega la URL del servidor en la configuración del conector, aprueba en el navegador y las herramientas aparecen en el chat.

¿Necesito una configuración de entorno?

No. La credencial elige Test o Live. Con OAuth eliges en la pantalla de aprobación. Con una clave API, el prefijo de la clave lo decide. No hay argumento de entorno, cabecera ni configuración.

¿Puede un script usarlo sin OAuth?

Sí. Envía una clave API como token de portador en la cabecera Authorization. Las claves de Test empiezan con oh_test_ y nunca se cobran.

¿La lista de herramientas es la misma que la API REST?

Sí. Cada endpoint público es una herramienta. El nombre de la herramienta proviene del ID de operación, como instagram_get_profile. Las entradas y respuestas coinciden con la API REST.

¿Dónde veo cuánto gastó mi agente?

En el panel de control, en Historial de solicitudes. Las llamadas MCP aparecen con el canal mcp. Cada fila tiene la herramienta, el entorno y el cargo.

Documentación: https://openhandle.dev/docs/mcp.md · Prueba con MCP: https://openhandle.dev/docs/test-environment/mcp.md