Conecta Claude y ChatGPT a precios del oro en tiempo real con MCP
Conecta Claude, ChatGPT, Cursor y VS Code a precios del oro y otros metales en tiempo real con el servidor MCP de MetalAPI: OAuth o clave API, herramientas y cuotas.
Por qué un asistente necesita una herramienta de precios
Pregúntale a un asistente de chat sin herramientas por el precio del oro de hoy y obtendrás una de tres respuestas: una negativa, un número de sus datos de entrenamiento o una suposición expresada con más seguridad de la que merece. Ninguna sirve. Un modelo de lenguaje aprende de una instantánea de texto que termina meses antes de que hables con él, mientras que los precios del oro, la plata y el petróleo se mueven cada pocos segundos mientras los mercados están abiertos.
La solución habitual es buscar el precio tú mismo y pegarlo en el chat. Funciona para una pregunta y después deja de funcionar. Tienes que recordar qué unidad copiaste (¿onza troy o gramo?), qué divisa y cuándo se tomó el número. Haz una pregunta de seguimiento sobre el rango del mes pasado, o una conversión a liras turcas, y vuelves a estar en el navegador.
El Model Context Protocol (MCP) elimina ese paso. El asistente recibe un pequeño conjunto de herramientas que puede llamar por sí mismo, y cada respuesta se construye a partir de una respuesta reciente de la API que incluye su propia marca de tiempo, divisa base y unidad. Este artículo muestra cómo conectar Claude, ChatGPT, Claude Code, Cursor y VS Code al servidor MCP de MetalAPI, qué puede hacer el asistente una vez conectado y qué salvaguardas se aplican.
| Aspecto | Pegar números a mano | Llamar a una herramienta MCP |
|---|---|---|
| Actualidad | Lo que copiaste, cuando lo copiaste | El último precio que permite tu plan, obtenido cuando preguntas |
| Unidades y divisa | Es fácil confundir onzas troy, gramos y divisas | Argumentos base y unit explícitos, repetidos en la respuesta |
| Marca de tiempo | Normalmente se pierde por el camino | Cada respuesta incluye timestamp y date |
| Preguntas de seguimiento | Otra búsqueda manual | El asistente llama a otra herramienta |
| Historial y conversiones | Otro sitio web u hoja de cálculo | Herramientas de series temporales, OHLC, variación y conversión |
Qué es MCP
MCP es un protocolo abierto, presentado por Anthropic en 2024 y admitido hoy por muchas aplicaciones de IA, que estandariza cómo se comunica un asistente con herramientas y datos externos. Un servidor MCP publica una lista de herramientas. Cada herramienta tiene un nombre, una descripción en lenguaje natural, un esquema JSON para sus argumentos y anotaciones opcionales como "solo lectura". Un cliente MCP (Claude, ChatGPT, Cursor, VS Code y otros) lee esa lista, deja que el modelo decida cuándo es relevante una herramienta, envía la llamada al servidor y devuelve el resultado al modelo.
El modelo nunca ve tus credenciales ni se comunica directamente con la API. Genera una solicitud estructurada como "llama a get_latest_prices con symbols: XAU y base: EUR", el cliente la ejecuta y el modelo redacta su respuesta a partir del JSON que recibe.
El servidor de MetalAPI está en https://metalapi.com/mcp. Usa Streamable HTTP, el transporte remoto definido en la especificación MCP, y no tiene estado: cada llamada es una solicitud HTTPS independiente con una respuesta JSON, así que no hay ninguna sesión de larga duración que mantener viva. El servidor figura en el registro oficial de MCP (MCP Registry) como com.metalapi/metalapi. Si abres la URL en un navegador, se te redirige a la página de presentación de IA y MCP.
Inicia sesión con OAuth o usa una clave API
Cada llamada al servidor está autenticada. Hay dos formas de hacerlo, y la adecuada depende del cliente:
- OAuth 2.1 (inicio de sesión) para apps con una pantalla de conectores, como Claude y ChatGPT. El cliente descubre el servidor de autorización por sí mismo: una llamada sin autenticar recibe una respuesta
401con una cabeceraWWW-Authenticateque apunta a los metadatos de recurso protegido del servidor. Después, el cliente se registra mediante el registro dinámico de clientes y abre una página de inicio de sesión de MetalAPI. El flujo usa PKCE, así que no hace falta incluir ningún secreto de cliente en la app. Inicias sesión, o creas una cuenta gratuita, y apruebas la conexión. - Clave API para herramientas de desarrollo que permiten definir cabeceras HTTP, como Claude Code, Cursor y VS Code. Envías la misma clave que usas para la API REST como
Authorization: Bearer mk_live_….
Ambas vías llevan a la misma cuenta, el mismo plan y la misma cuota. Hay una diferencia en la lista de herramientas: create_api_key solo se ofrece en las conexiones OAuth. Una clave copiada en un archivo de configuración nunca debería poder generar más claves, así que una conexión con clave ve doce herramientas en lugar de trece.
Las conexiones OAuth aparecen en tu panel en Settings → Connected apps, donde puedes desconectar cualquiera de ellas. Las claves API se pueden rotar o revocar en API keys. Trata una clave en un archivo de configuración MCP exactamente igual que una clave en tu código fuente.
Conecta Claude y ChatGPT
Para Claude en claude.ai y en Claude Desktop:
- Abre Settings → Connectors y elige Add custom connector.
- Ponle el nombre MetalAPI e introduce
https://metalapi.com/mcp. - Haz clic en Connect, inicia sesión en MetalAPI (o crea una cuenta gratuita) y haz clic en Allow.
En ChatGPT, abre Settings → Apps & Connectors y crea un conector en modo desarrollador con la URL https://metalapi.com/mcp y autenticación OAuth. ChatGPT abre la página de inicio de sesión de MetalAPI; aprueba la conexión y las herramientas estarán disponibles en tus chats. Que puedas añadir conectores personalizados depende de tu plan de ChatGPT y, en un espacio de trabajo, de lo que permita el administrador.
Los nombres de los menús de ambas apps cambian de vez en cuando. La guía de configuración de MCP se mantiene al día con los pasos actuales de cada cliente.
En tu primera conversación ayuda nombrar la fuente ("Usando MetalAPI, ¿cuál es…") para que el asistente recurra a la herramienta en lugar de a su memoria. Después, la mayoría de los asistentes eligen la herramienta por su cuenta siempre que una pregunta tiene que ver con un precio.
Conecta Claude Code, Cursor y VS Code
Los asistentes de programación suelen usar una clave API. Crea una en el panel (el plan Free basta para empezar) y usa una clave distinta para cada herramienta, para poder revocar una sin afectar a las demás.
En Claude Code, añade el servidor desde la terminal:
claude mcp add --transport http metalapi https://metalapi.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Si prefieres no guardar una clave, añade el servidor sin --header y ejecuta /mcp dentro de Claude Code para iniciar sesión con OAuth.
En Cursor, añade el servidor a ~/.cursor/mcp.json, o a .cursor/mcp.json dentro de un proyecto:
{
"mcpServers": {
"metalapi": {
"url": "https://metalapi.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}En VS Code con GitHub Copilot, guarda lo siguiente como .vscode/mcp.json. El bloque inputs hace que VS Code te pida la clave una vez y la guarde de forma segura, así que la clave nunca queda en el propio archivo:
{
"inputs": [
{ "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
],
"servers": {
"metalapi": {
"type": "http",
"url": "https://metalapi.com/mcp",
"headers": { "Authorization": "Bearer ${input:metalapi-key}" }
}
}
}Otros clientes que admiten servidores MCP remotos mediante Streamable HTTP, como Windsurf, siguen el mismo patrón: la URL del servidor más una cabecera Bearer o un inicio de sesión OAuth.
Cómo es una conversación
Una vez conectado, preguntas en lenguaje natural y el asistente elige una herramienta y sus argumentos. Algunas preguntas típicas y las llamadas a las que dan lugar:
| Preguntas | Herramienta | Argumentos |
|---|---|---|
| ¿Cuánto cuesta ahora mismo el gramo de oro en euros? | get_latest_prices | symbols: XAU, base: EUR, unit: gram |
| ¿Cómo se ha movido la plata en las dos últimas semanas? | get_timeseries o get_fluctuation | symbols: XAG, start_date, end_date |
| Convierte 2,5 onzas troy de platino a liras turcas. | convert | from: XPT, to: TRY, amount: 2.5 |
| ¿Cuáles han sido hoy la apertura, el máximo, el mínimo y el cierre del oro? | get_ohlc | symbols: XAU |
| ¿Cuánto cuesta el gramo de oro de 18K en libras? | get_carat_prices | base: GBP (planes de pago) |
| ¿En qué plan estoy y cuánta cuota me queda? | get_account | Ninguno |
Las herramientas de precios devuelven un JSON compacto. El bloque rates de la API REST muestra cada símbolo dos veces, como precio y como su inverso, por compatibilidad con integraciones antiguas. El servidor MCP conserva solo los precios, indexados por símbolo, en prices. Eso reduce los tokens aproximadamente a la mitad y elimina la forma más habitual de malinterpretar los datos. Una llamada a get_latest_prices con symbols: XAU,XAG, base: EUR y unit: gram devuelve algo así:
{
"success": true,
"timestamp": 1792834892,
"date": "2026-10-24",
"base": "EUR",
"unit": "gram",
"rate_limit": {
"limit": 10000,
"remaining": 9874,
"reset": 1793491200,
"used": 126,
"plan": "Standard",
"reset_date": "2026-11-01T00:00:00.000Z"
},
"prices": {
"XAU": 110.4064149,
"XAG": 1.489616277
}
}Las cifras de este artículo son ilustrativas. Las respuestas reales usan los últimos precios que permite tu plan.
Como cada respuesta incluye timestamp, base y unit, una buena respuesta dice que el oro estaba a unos 110 € por gramo en un momento determinado, no solo "110 €". Si una respuesta omite ese contexto, pídeselo.
Los asistentes también pueden encadenar llamadas. Si le pides que compare la relación oro/plata de hoy con la de hace un mes, un asistente puede obtener ambos metales en ambas fechas y hacer la división por sí mismo. Si le pides un gráfico, un cliente que pueda ejecutar código puede convertir en uno el resultado de get_timeseries.
Las 13 herramientas
El servidor ofrece trece herramientas. Siete devuelven datos de mercado y cuentan como una solicitud cada una en la cuota mensual de tu plan, exactamente igual que una llamada REST. Las demás son gratuitas.
| Herramienta | Qué hace | Cuota |
|---|---|---|
get_latest_prices | Últimos precios de metales, energía, divisas y criptomonedas, en cualquier divisa base y unidad de masa | 1 solicitud |
get_historical_prices | Precios de cierre de un día pasado | 1 solicitud |
convert | Convierte un importe entre dos símbolos, al último precio o en un día pasado | 1 solicitud |
get_timeseries | Precios de cierre diarios entre dos fechas (hasta 30 días por llamada en Free y 365 en los planes de pago) | 1 solicitud |
get_fluctuation | Precio inicial y final, variación absoluta y porcentual entre dos fechas | 1 solicitud |
get_ohlc | Apertura, máximo, mínimo y cierre de un día | 1 solicitud |
get_carat_prices | Precios del oro por quilate, como 22K o 18K (planes de pago) | 1 solicitud |
list_symbols | Todos los códigos de símbolo con nombre, categoría y unidad | Gratis |
get_account | Tu plan, cuota mensual, uso y fecha de restablecimiento | Gratis |
list_plans | Todos los planes con sus límites y precios mensuales y anuales | Gratis |
list_api_keys | Tus claves API activas, enmascaradas | Gratis |
create_api_key | Crea una clave para tus propias apps; solo en conexiones OAuth; pregunta antes | Gratis |
get_upgrade_link | Prepara un enlace de pago de Stripe, o un enlace al portal de facturación para suscriptores; pregunta antes | Gratis |
Cuando un cliente se conecta, el servidor también envía unas instrucciones breves: qué significan los códigos de símbolo, que los precios de los metales son por onza troy salvo que se indique una unidad y que las herramientas de datos consumen cuota. Los clientes se las pasan al modelo, y por eso un asistente bien diseñado solo pide los símbolos que necesita. Menos símbolos significa respuestas más cortas y menos tokens.
Seguridad: solo lectura por defecto, sin pagos
Conectar un asistente a una cuenta plantea una pregunta razonable: ¿qué puede cambiar? El diseño mantiene la respuesta corta.
- Once de las trece herramientas son de solo lectura. Llevan la anotación MCP
readOnlyHinty solo pueden leer precios, tu plan, tu uso y los datos enmascarados de tus claves. - Las dos herramientas de escritura preguntan antes.
create_api_keyyget_upgrade_linkestán marcadas como acciones que cambian algo, así que los clientes MCP te piden confirmación antes de ejecutarlas. - El servidor nunca cobra nada.
get_upgrade_linkcrea una sesión de pago de Stripe para el plan que has pedido, o un enlace al portal de facturación si ya estás suscrito, y devuelve la URL. Tú la abres, compruebas el precio y pagas. El asistente no puede completar un pago. - Las claves nuevas se muestran una sola vez. Una clave creada con
create_api_keyse devuelve completa una única vez, como en el panel, y solo se guarda un hash de ella. - Alcance limitado. La conexión llega a MetalAPI y a nada más: precios, tu plan, tu uso y tus claves API. El servidor nunca ve tus conversaciones, tus archivos ni otros conectores.
- Registrado como el tráfico de la API. Las llamadas de datos de mercado aparecen en el registro de solicitudes de tu panel como
/mcp/seguido del nombre de la herramienta, junto a tus solicitudes REST.
Hay un hábito general de MCP que vale la pena mantener con cualquier servidor: lee los avisos de confirmación que muestra tu cliente en lugar de aprobarlos por reflejo, y elimina los conectores que ya no uses.
Cuotas, actualidad y planes
Las llamadas MCP consumen la misma cuota que la API REST. Una llamada a una herramienta de datos cuesta una solicitud, devuelva los símbolos que devuelva, mientras que list_symbols y las herramientas de cuenta no cuestan nada. También se aplican los límites por minuto, a partir de 10 solicitudes por minuto en Free.
Los precios son tan recientes como permite tu plan. En el plan Free, el asistente ve precios diarios; los planes de pago se actualizan desde cada 30 minutos hasta cada 5 segundos:
| Plan | Precio / mes | Solicitudes / mes | Intervalo de actualización |
|---|---|---|---|
| Free | 0 USD | 100 | Diario |
| Lite | 4,99 USD | 1000 | 30 minutos |
| Standard | 11,99 USD | 10.000 | 10 minutos |
| Advanced | 24,99 USD | 50.000 | 1 minuto |
| Pro | 49,99 USD | 100.000 | 1 minuto |
| Ultra | 99,99 USD | 500.000 | 15 segundos |
| Business | 149,99 USD | 500.000 | 15 segundos |
| Enterprise | 299,99 USD | 1.500.000 | 5 segundos |
Cien solicitudes al mes cubren preguntas ocasionales en un chat. Si usas un asistente para análisis que consultan muchas series, o lo integras en un agente que se ejecuta de forma programada, pídele get_account de vez en cuando: indica las solicitudes usadas, las restantes y cuándo se restablece la cuota. Cuando se agota la cuota mensual, las herramientas de datos devuelven un error de cuota excedida con un enlace para cambiar de plan hasta el día 1 del mes (UTC), mientras que las herramientas de cuenta siguen funcionando. La página de precios tiene la comparación completa.
Empezar lleva un par de minutos: regístrate para obtener una cuenta gratuita, sigue la guía de configuración de MCP para tu cliente y haz tu primera pregunta. La página de IA y MCP resume la configuración, y la documentación de la API describe los endpoints REST que hay detrás de cada herramienta.
Pruébalo con tus propios datos
Crea una cuenta gratuita y haz tu primera solicitud en menos de dos minutos. 100 solicitudes al mes, sin tarjeta de crédito.
Sigue leyendo
Spot, bid, ask y spread: cómo se cotizan los metales preciosos
Qué significan spot, bid, ask, precio medio y spread en el oro, la plata, el platino y el paladio, cómo cotizan los distribuidores y cómo mostrar bid/ask vía API.
Precios del cobre, el aluminio, el zinc y el petróleo por API: guía para desarrolladores
Obtén por API precios del cobre, aluminio, zinc, acero, petróleo y gas natural: unidades de cada mercado, normalización, futuros, conversiones y ejemplos de código.
Cómo elegir una API de precios de metales preciosos: 12 preguntas clave
Una lista neutral para elegir una API de precios de metales preciosos: fuentes, actualidad, historial, unidades, bid/ask, límites, precio, seguridad, licencia y MCP.