← Back to integrations

JADE REALMS / Developer documentation

Connect with MCP

Choose a client that supports remote Streamable HTTP servers. Add the endpoint below, select no authentication, then discover the tools. A browser tab does not need to remain open.

v1.0.0Read-only · no API keyOpenAPI JSON ↗

Connection steps

Choose a client that supports remote Streamable HTTP servers. Add the endpoint below, select no authentication, then discover the tools. A browser tab does not need to remain open.

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

Current browser WebMCP is a separate integration. This /mcp endpoint uses the standard remote protocol. OAuth and private purchased-library access are not part of this release.

MCP tools

MCP toolsREST APIRequired
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

Search → inspect → download

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

Client example

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": "en"
    }
  });
  console.log(result.structuredContent);
} finally {
  await client.close();
}

Protocol examples

A GET in the address bar returns 405 because this endpoint expects MCP POST messages. Use the examples below or the official SDK client to test it.

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"}}}'

Scope and compatibility

The server returns metadata and file URLs. It cannot purchase, inspect a private account, write to a local project or render an interactive 3D viewer inside every chat client.

Only anonymous, published catalog facts are returned. Unknown facts remain null; recorded import checks apply to the exact GLB hash and do not certify performance.

Metadata shares a best-effort edge limit of 120 requests per minute per IP at each Cloudflare location. File downloads have no account download quota.

  • 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

Errors and retries

HTTP / JSON-RPCDescription
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.

Add to a collection

New collection