Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.superglue.cloud/llms.txt

Use this file to discover all available pages before exploring further.

superglue exposes your tools through Model Context Protocol (MCP), giving AI agents direct access to execute pre-built superglue tools.
The MCP interface provides discovery and execution of pre-built superglue tools. It does not support ad-hoc system creation or tool building. Use MCP in production for agentic use cases and internal GPTs.

​
When to use MCP

Controlled Access

Execute only pre-approved, tested tools. No ad-hoc code generation or system modification.

Tool Execution in Production

Execute saved tools from your custom GPTs with full observability and error handling.

Agent Automation

Give AI agents the ability to discover and execute complex multi-system superglue tools without manual API wiring.

Internal Tooling

Expose business logic as AI-accessible tools for customer support, ops teams, or automated tasks.

​
Installation

​
Cursor

Add to your Cursor MCP settings (.cursor/config.json or via Settings → MCP): 
{
  "mcpServers": {
    "superglue": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.superglue.cloud/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

​
Claude Desktop

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 
{
  "mcpServers": {
    "superglue": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.superglue.cloud/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

​
Self-Hosted

Point to your self-hosted REST API and add a /mcp path: 
{
  "mcpServers": {
    "superglue": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3002/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Get your API key from the superglue web application sidebar under API Keys.
Enterprise: MCP access inherits your org RBAC from the API key used for authentication. The MCP server only exposes and executes tools that key is permitted to use.

​
Available Tools

The MCP server exposes:
  1. Native MCP tools for each saved superglue tool (registered automatically at startup)
  2. An authenticate helper tool for end-user reauthentication flows

​
superglue tools (auto-registered as MCP tools)

Every pre-built superglue tool available to the authenticated API key is registered as its own MCP tool. How names are generated:
  • Tool names are derived from superglue tool IDs
  • Non-alphanumeric characters are replaced with underscores
  • Name collisions are resolved with numeric suffixes
Input schema:
  • Uses each superglue tool’s payload schema when available
  • Falls back to a permissive object schema for dynamic payloads
Returns:
  • JSON string content with { success, data } on success
  • JSON string content with { success: false, error } on failure
  • Large execution results are truncated before returning
Behavior:
  • Executes with saved credentials from systems used during build
  • Sends execution telemetry and logs to superglue

​
authenticate

Generates an authentication link to help users reconnect credentials when execution fails due to missing auth. Input Schema: 
{
  systemId?: string;
}
Returns: 
{
  success: boolean;
  portalUrl?: string;
  agentUrl?: string;
  message?: string;
  error?: string;
  suggestion?: string;
}

​
Troubleshooting

​
Connection Issues

# Test MCP endpoint (Streamable HTTP endpoint)
curl https://mcp.superglue.cloud/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

​
Tool Not Found

Error: "Unknown tool"
Solution: Restart your MCP client after creating/updating superglue tools, then pick the tool name exactly as listed by tools/list.

​
Next Steps

Create a Tool

Build tools to expose via MCP

Creating a System

Connect and configure external systems

API Reference

Direct REST API access

Set Up Guide

Deploy self-hosted MCP server