TopxAI Models

npx add-mcp 'https://ai.topxea.com/mcp/models'

Use el catálogo de TopxAI desde Claude Code, Cursor, VS Code o cualquier cliente que hable el Model Context Protocol. Los servidores se autentican con la misma clave de API que la API, facturan los mismos precios y añaden una pequeña tarifa fija por llamada a herramienta.

Cómo se factura

• Una llamada a herramienta que llega a un modelo se factura exactamente igual que la misma solicitud realizada a través de la API, más la tarifa fija por llamada del servidor por el que pasó.
• Una llamada que el proveedor falla no se factura: ni el precio del modelo ni la tarifa de llamada.
• Un trabajo de video que el proveedor falla después de aceptarlo se reembolsa por completo.
• Cada respuesta informa del cargo exacto, y cada llamada aparece en el registro de uso con su tarifa de llamada como una línea separada.

Servidores

TopxAI Models

Pregunte a cualquier modelo de texto del catálogo desde dentro de la conversación de otro modelo: una segunda opinión, una revisión o un modelo que el anfitrión no tenga.

Endpoint https://ai.topxea.com/mcp/models · $0.001 por llamada

Herramienta	Qué hace
list_models	Lista los modelos de texto a los que esta clave de API puede preguntar, con sus precios en USD por millón de tokens y la tarifa de llamada.
ask_model	Envía un prompt a un modelo de texto del catálogo de TopxAI y devuelve su respuesta. Se factura al precio de tokens del modelo más una tarifa de llamada de $0.001; la respuesta informa del cargo exacto.
judge	Pregunta a Jev de TypeSafe (un modelo System One) preguntas tipadas sobre un fragmento de texto y obtén números calibrados, no prosa: una probabilidad para una pregunta de sí/no (tipo noul), una opción con una probabilidad por opción (tipo choice, con criterios), o un valor en una escala con una probabilidad por ancla (tipo score, con anclas). Se factura al precio de tokens de entrada de Jev más una tarifa de llamada de $0.001.

Ejemplo: list_models

Usted dice: ¿A qué modelos puedo preguntar a través de TopxAI y cuánto cuestan?

Llamada a herramienta:

{"arguments":{},"name":"list_models"}

Resultado:

{"call_fee_usd":0.001,"models":[{"input_usd_per_million_tokens":5,"model":"gpt-6-astra","output_usd_per_million_tokens":25,"route":"openai-shared","unit":"per_million_tokens"}]}

Ejemplo: ask_model

Usted dice: Pide a GPT-6 una segunda opinión sobre este plan de migración y enumera los riesgos que ve.

Llamada a herramienta:

{"arguments":{"max_cost_usd":0.05,"max_output_tokens":1024,"model":"gpt-6-astra","prompt":"Review this migration plan for risks: …"},"name":"ask_model"}

Resultado:

{"call_fee_usd":0.001,"charged":true,"charged_usd":0.01026,"finish_reason":"stop","model":"gpt-6-astra","request_id":"2026092208…","route":"openai-shared","usage":{"completion_tokens":288,"prompt_tokens":412}}

Ejemplo: judge

Usted dice: Usa Jev para determinar si este ticket de soporte es urgente y de qué trata.

Llamada a herramienta:

{"arguments":{"questions":{"topic":{"criteria":{"account_access":"Login, password, permissions","billing":"Charges, invoices, refunds","integration":"Connecting a payment provider or an API","other":null},"instructions":"What is the message about?","type":"choice"},"urgency":{"instructions":"Does this message express urgency?","type":"noul"}},"state":"Hi, I have been trying to connect my Stripe account for 3 days and it keeps failing. I am losing sales. Please help ASAP."},"name":"judge"}

Resultado:

{"answers":{"topic":{"choice":"integration","confidence":1,"probabilities":{"account_access":0,"billing":0,"integration":1,"other":0},"type":"choice"},"urgency":{"noul":0.98,"type":"noul"}},"call_fee_usd":0.001,"charged":true,"charged_usd":0.00102,"model":"jev-1.13.0","request_id":"2026092208…","route":"typesafe-official","usage":{"input_tokens":447}}

TopxAI Images

Genera imágenes con el modelo de imagen del catálogo y recíbelas en línea.

Endpoint https://ai.topxea.com/mcp/images · $0.01 por llamada

Herramienta	Qué hace
generate_image	Genera una o más imágenes a partir de un prompt con el modelo de imagen de TopxAI. Se factura al precio por solicitud del modelo más una tarifa de llamada de $0.01. Devuelve las imágenes en línea y como enlaces firmados temporales válidos hasta una hora; la capacidad de caché puede expirarlos antes.

Ejemplo: generate_image

Usted dice: Dibuja un póster de un zorro en la nieve, en horizontal.

Llamada a herramienta:

{"arguments":{"n":1,"prompt":"A fox in the snow, poster style","size":"1536x1024"},"name":"generate_image"}

Resultado:

{"call_fee_usd":0.01,"charged":true,"charged_usd":0.06,"images":1,"model":"gpt-image-2.5-sunburst","n":1,"request_id":"2026092208…","size":"1536x1024","urls":["https://ai.topxea.com/v1/images/content/…"]}

TopxAI Videos

Envía un trabajo de generación de video y haz polling hasta que el clip esté listo.

Endpoint https://ai.topxea.com/mcp/videos · $0.01 por llamada

Herramienta	Qué hace
generate_video	Envía un trabajo de texto a video. Se factura por segundo de la duración solicitada más una tarifa de llamada de $0.01 cuando el proveedor acepta el trabajo; un trabajo que falla se reembolsa. Haz polling de video_status con el request_id devuelto.
video_status	Informa del estado de un trabajo de video enviado con generate_video. Gratuito. Cuando el estado es done, content_url sirve el clip a la misma clave de API.

Ejemplo: generate_video

Usted dice: Haz un clip de 8 segundos en 720p de olas al atardecer.

Llamada a herramienta:

{"arguments":{"duration":8,"prompt":"Waves at dusk, slow motion","resolution":"720p"},"name":"generate_video"}

Resultado:

{"billing_request_id":"2026092208…","call_fee_usd":0.01,"charged":true,"charged_usd":0.81,"duration":8,"model":"grok-imagine-video-1.5","request_id":"vid_8f3…","resolution":"720p","status":"pending"}

Ejemplo: video_status

Usted dice: ¿Está listo el video ya?

Llamada a herramienta:

{"arguments":{"request_id":"vid_8f3…"},"name":"video_status"}

Resultado:

{"content_url":"https://ai.topxea.com/v1/videos/vid_8f3…/content","progress":100,"request_id":"vid_8f3…","status":"done"}

Conectar

Cada cliente usa la URL del servidor con la clave de API en el encabezado Authorization. Con Claude Code:

claude mcp add --transport http topxai-models https://ai.topxea.com/mcp/models --header "Authorization: Bearer sk-your-key"

Cursor lee el mismo servidor desde .cursor/mcp.json y VS Code desde .vscode/mcp.json; la página de la aplicación rellena los fragmentos con una de sus propias claves.

Obtén una clave de API · Precio de cada modelo · Documentación · TopxAI