← Volver a integraciones

JADE REALMS / Documentación para desarrolladores

Conectar con MCP

Añade la URL en un cliente compatible con Streamable HTTP remoto, selecciona sin autenticación y descubre las herramientas. No hace falta mantener el navegador abierto.

v1.0.0Solo lectura · sin clave APIOpenAPI JSON ↗

Pasos de conexión

Añade la URL en un cliente compatible con Streamable HTTP remoto, selecciona sin autenticación y descubre las herramientas. No hace falta mantener el navegador abierto.

URL
https://3dmodelhub.io/mcp
  1. Add a remote MCP server using this URL and Streamable HTTP transport.
  2. Select None for authentication. This public service has no API key or OAuth sign-in step.
  3. Discover the seven tools below. Read site information, search models, then request download URLs.
Transport
Streamable HTTP
Authentication
None
Server
jaderealms-public-assets

Es independiente de WebMCP del navegador. OAuth, bibliotecas compradas y pedidos privados no se incluyen en esta versión.

Herramientas MCP

Herramientas MCPREST APIObligatorio
jaderealms_get_site_infoGET /api/v1/site—
jaderealms_search_modelsGET /api/v1/models—
jaderealms_get_model_detailsGET /api/v1/models/{id}id
jaderealms_list_scene_kitsGET /api/v1/kits—
jaderealms_get_scene_kit_detailsGET /api/v1/kits/{id}id
jaderealms_get_usage_guidanceGET /api/v1/guidancetopic
jaderealms_get_model_downloadsGET /api/v1/models/{id}/downloadsid

Buscar → consultar → descargar

Tool arguments
{
  "name": "jaderealms_search_models",
  "arguments": {
    "q": "pine",
    "tested_engine": "godot",
    "max_triangles": 150000,
    "limit": 3,
    "locale": "es"
  }
}

Cliente de ejemplo

Setup
npm install --save-exact @modelcontextprotocol/sdk@1.32.1
JavaScript · Node.js 22+
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'asset-library-client', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(new URL("https://3dmodelhub.io/mcp")));
  console.log(await client.listTools());
  const result = await client.callTool({
    "name": "jaderealms_search_models",
    "arguments": {
      "q": "pine",
      "tested_engine": "godot",
      "max_triangles": 150000,
      "limit": 3,
      "locale": "es"
    }
  });
  console.log(result.structuredContent);
} finally {
  await client.close();
}

Ejemplos de protocolo

Un GET en la barra de direcciones devuelve 405. El servidor recibe mensajes MCP POST; usa estos ejemplos o el SDK oficial.

1 · initialize
curl --fail 'https://3dmodelhub.io/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"manual-check","version":"1.0.0"}}}'

Alcance y compatibilidad

Devuelve metadatos y URL. No compra, lee cuentas privadas ni escribe en proyectos locales. La vista 3D en el chat depende del cliente.

Solo devuelve datos publicados. Lo desconocido es null; las verificaciones corresponden al hash GLB registrado y no certifican rendimiento.

Los metadatos comparten un límite al mejor esfuerzo de 120 peticiones por minuto e IP en cada ubicación Cloudflare; no es una cuota de archivos gratuitos.

  • POST: initialize / notifications / tools/list / tools/call
  • GET / DELETE: 405 · OPTIONS: 204
  • JSON response · no persistent session ID · 32 KiB message limit
  • tools/call: content + structuredContent; isError=true on invalid arguments

Errores y reintentos

HTTP / JSON-RPCDescripción
405GET from an address bar is unsupported; connect with MCP POST.
406Accept must include both application/json and text/event-stream.
415Send JSON with Content-Type: application/json.
403Browser Origin is not allowed. Default origins cover this site and configured ChatGPT, Claude and Cursor origins. A site administrator can configure MCP_ALLOWED_ORIGINS for another browser client.
413Messages must fit within 32 KiB; batch messages are unsupported.
429Wait for Retry-After before retrying.
JSON-RPC / tools/callCheck JSON-RPC error first. If result.isError is true, inspect structuredContent or text for the tool error instead of treating it as success.

Añadir a una colección

Nueva colección