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": 115,
# "readOnly": false,
# "writeToolCount": 61,
# "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
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. 2. Bearer token — create a connection in Dashboard → Integrations → AI Connections and paste the smcp_ token into the header-based snippets below.
Claude (OAuth connect)
Claude settings → Connectors → Add custom connector
https://app.simplio3d.ai/mcp
No token needed — Claude discovers Simplio3D's OAuth endpoints, opens the consent page, and you pick the workspace + scopes to grant.Claude 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
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.