Skip to main content

Quickstart

1. Create Broker Credentials​

  1. Open https://portal.madpanda3d.com/.
  2. Configure at least one MCP under Integrations.
  3. Go to Configurations and generate a broker credential set.

2. Initialize MCP Session​

{
  "jsonrpc": "2.0",
  "id": "init",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "my-client", "version": "1.0.0" }
  }
}

3. Discover the Right Tool​

{
  "jsonrpc": "2.0",
  "id": "find",
  "method": "tools/call",
  "params": {
    "name": "portal.find_tools",
    "arguments": {
      "query": "semantic search course notes",
      "configuredOnly": true,
      "limit": 8
    }
  }
}

4. Fetch the Lossless Descriptor​

{
  "jsonrpc": "2.0",
  "id": "reference",
  "method": "tools/call",
  "params": {
    "name": "portal.get_tool_reference",
    "arguments": {
      "serviceId": "qdrant",
      "toolName": "qdrant-find"
    }
  }
}

5. Execute Through the Risk-Matched Tool​

  • Read-only tool: portal.call_read_tool.
  • Write tool: call portal.preview_tool_call, then portal.call_write_tool with the unchanged arguments and preview token.
  • Destructive tool: preview first, then call portal.call_destructive_tool with the exact descriptor-defined confirmation phrase.

Never retry a non-idempotent outcome_unknown result automatically. Inspect provider state first.

6. Validate the Result​

  • Confirm the normalized envelope has ok: true, the expected serviceId and toolName, and a traceId.
  • Treat isError: true, ok: false, success: false, and provider failed statuses as failures.
  • Follow pagination or resource links when a result is larger than the default response budget.
  • Rotate credentials if any token exposure is suspected.