MetalAPI
XAU3997,89−1,54 %XAG53,936−1,51 %XPT1554,47−0,83 %XPD1047,03−0,44 %XCU6,5080+2,29 %WTI103,27+3,82 %BRENT111,70−1,30 %EUR1,120400−0,01 %GBP1,337500−0,01 %JPY0,0063761+0,14 %CHF1,213445−0,25 %TRY0,020125−0,12 %BTC80.329,75−0,55 %ETH2329,36−1,13 %
Todos los artículos
IAMCPClaudeGuía

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 MetalAPI Team··10 min de lectura

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.

AspectoPegar números a manoLlamar a una herramienta MCP
ActualidadLo que copiaste, cuando lo copiasteEl último precio que permite tu plan, obtenido cuando preguntas
Unidades y divisaEs fácil confundir onzas troy, gramos y divisasArgumentos base y unit explícitos, repetidos en la respuesta
Marca de tiempoNormalmente se pierde por el caminoCada respuesta incluye timestamp y date
Preguntas de seguimientoOtra búsqueda manualEl asistente llama a otra herramienta
Historial y conversionesOtro sitio web u hoja de cálculoHerramientas 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 401 con una cabecera WWW-Authenticate que 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:

  1. Abre Settings → Connectors y elige Add custom connector.
  2. Ponle el nombre MetalAPI e introduce https://metalapi.com/mcp.
  3. 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 Code
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:

~/.cursor/mcp.json
{
  "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:

.vscode/mcp.json
{
  "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:

PreguntasHerramientaArgumentos
¿Cuánto cuesta ahora mismo el gramo de oro en euros?get_latest_pricessymbols: XAU, base: EUR, unit: gram
¿Cómo se ha movido la plata en las dos últimas semanas?get_timeseries o get_fluctuationsymbols: XAG, start_date, end_date
Convierte 2,5 onzas troy de platino a liras turcas.convertfrom: 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_ohlcsymbols: XAU
¿Cuánto cuesta el gramo de oro de 18K en libras?get_carat_pricesbase: GBP (planes de pago)
¿En qué plan estoy y cuánta cuota me queda?get_accountNinguno

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í:

Resultado de get_latest_prices (ilustrativo)
{
  "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.

HerramientaQué haceCuota
get_latest_pricesÚltimos precios de metales, energía, divisas y criptomonedas, en cualquier divisa base y unidad de masa1 solicitud
get_historical_pricesPrecios de cierre de un día pasado1 solicitud
convertConvierte un importe entre dos símbolos, al último precio o en un día pasado1 solicitud
get_timeseriesPrecios de cierre diarios entre dos fechas (hasta 30 días por llamada en Free y 365 en los planes de pago)1 solicitud
get_fluctuationPrecio inicial y final, variación absoluta y porcentual entre dos fechas1 solicitud
get_ohlcApertura, máximo, mínimo y cierre de un día1 solicitud
get_carat_pricesPrecios del oro por quilate, como 22K o 18K (planes de pago)1 solicitud
list_symbolsTodos los códigos de símbolo con nombre, categoría y unidadGratis
get_accountTu plan, cuota mensual, uso y fecha de restablecimientoGratis
list_plansTodos los planes con sus límites y precios mensuales y anualesGratis
list_api_keysTus claves API activas, enmascaradasGratis
create_api_keyCrea una clave para tus propias apps; solo en conexiones OAuth; pregunta antesGratis
get_upgrade_linkPrepara un enlace de pago de Stripe, o un enlace al portal de facturación para suscriptores; pregunta antesGratis

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 readOnlyHint y solo pueden leer precios, tu plan, tu uso y los datos enmascarados de tus claves.
  • Las dos herramientas de escritura preguntan antes. create_api_key y get_upgrade_link está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_link crea 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_key se 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:

PlanPrecio / mesSolicitudes / mesIntervalo de actualización
Free0 USD100Diario
Lite4,99 USD100030 minutos
Standard11,99 USD10.00010 minutos
Advanced24,99 USD50.0001 minuto
Pro49,99 USD100.0001 minuto
Ultra99,99 USD500.00015 segundos
Business149,99 USD500.00015 segundos
Enterprise299,99 USD1.500.0005 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