Connect a Client
Two ways to give an AI agent access to your Simplio3D data: the MCP server for MCP-capable clients, and the authenticated REST tool endpoint.
Also available: the REST tool endpoint
The same registry the MCP server exposes is also reachable over authenticated HTTP. Use it from your own agent framework, a script, or a serverless function.
List the available tools
Returns every tool your role can call, each with a JSON Schema you can hand straight to a model’s tool-calling API.
curl https://<your-project>.supabase.co/functions/v1/make-server-0532dd87/ai/tools \
-H "Authorization: Bearer $SIMPLIO3D_TOKEN"
# {
# "success": true,
# "count": 121,
# "readOnly": false,
# "writeToolCount": 66,
# "tools": [ { "name": "inspect_project", "readOnly": true, "inputSchema": { ... } },
# { "name": "adjust_prices", "readOnly": false, "risk": "high", ... }, ... ]
# }Execute a tool
Send the tool name and its arguments. The optional context object lets you supply the project the agent is working in (so projectId can be omitted from every call) and the shopper’s current selections.
curl -X POST https://<your-project>.supabase.co/functions/v1/make-server-0532dd87/ai/tools/execute \
-H "Authorization: Bearer $SIMPLIO3D_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"tool": "validate_project",
"args": { "projectId": "8f14e45f-ceea-467a-9c2b-1f4e6a7d0c31", "deep": true },
"context": { "projectId": "8f14e45f-ceea-467a-9c2b-1f4e6a7d0c31" }
}'
# { "success": true, "tool": "validate_project", "result": { "summary": {...}, "findings": [...] } }MCP clients
Listed in the official MCP Registry
Simplio3D is published in the Official MCP Registry as ai.simplio3d/platform, so MCP clients and directories that read the registry can find it by name. The listing is for discovery only: your client still connects directly to https://app.simplio3d.ai/mcp, you still sign in and choose the scopes to grant, and no data passes through the registry.
Claude — listed in the Claude connectors directory
Simplio3D is in Anthropic’s Claude connectors directory as a Community connector. In Claude (claude.ai, Desktop and mobile) open Customize → Connectors, search for Simplio3D and click Connect, or open the Simplio3D listing. Claude opens the Simplio3D sign-in and approval page, where you pick the workspace and the scopes to grant. Read-only access is pre-selected, so Claude can audit and explain your configurators but not change them until you tick write access, and Claude asks before every tool that changes or removes data. Adding https://app.simplio3d.ai/mcp with Add custom connector reaches the same server with the same sign-in.
Two ways to authenticate
1. OAuth 2.1 — add https://app.simplio3d.ai/mcp as a custom connector in Claude (or any OAuth-capable MCP client); the consent page lets you pick the workspace and scopes to grant, with read-only access pre-selected. 2. Bearer token — create a connection in Dashboard → Integrations → AI Connections and paste the smcp_ token into the header-based snippets below.
Claude (claude.ai, Desktop, mobile) — from the connectors directory
Claude → Customize → Connectors → search “Simplio3D” → Connect
https://claude.ai/directory/connectors/simplio3d
No token needed — Claude opens the Simplio3D sign-in and approval page, where you pick the workspace and the scopes to grant. Read-only access is pre-selected; tick write scopes only if you want the agent to make changes.
Alternative: Customize → Connectors → Add custom connector → https://app.simplio3d.ai/mcpClaude Desktop
claude_desktop_config.json → Settings → Developer → Edit Config
{
"mcpServers": {
"simplio3d": {
"type": "http",
"url": "https://app.simplio3d.ai/mcp",
"headers": {
"Authorization": "Bearer smcp_YOUR_CONNECTION_TOKEN"
}
}
}
}Claude Code
Run in your terminal
# Option A — sign in with OAuth (no token to copy)
claude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp
# then run /mcp inside Claude Code, pick simplio3d and choose Authenticate
# Option B — a scoped connection token from Dashboard → Integrations → AI Connections
claude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp \
--header "Authorization: Bearer smcp_YOUR_CONNECTION_TOKEN"Cursor
~/.cursor/mcp.json (global) or .cursor/mcp.json (per project)
{
"mcpServers": {
"simplio3d": {
"url": "https://app.simplio3d.ai/mcp",
"headers": {
"Authorization": "Bearer smcp_YOUR_CONNECTION_TOKEN"
}
}
}
}VS Code (GitHub Copilot)
.vscode/mcp.json
{
"servers": {
"simplio3d": {
"type": "http",
"url": "https://app.simplio3d.ai/mcp",
"headers": {
"Authorization": "Bearer ${input:simplio3d_token}"
}
}
},
"inputs": [
{
"id": "simplio3d_token",
"type": "promptString",
"description": "Simplio3D MCP connection token (smcp_…)",
"password": true
}
]
}Verify the connection
Once connected, ask your assistant a question that can only be answered from your data. If it lists your real project names, the tools are wired correctly:
List my Simplio3D projects and tell me which ones are published.