Skip to main content
Forge exposes its full platform surface through a REST API with an OpenAPI 3.1 specification. You can integrate with Forge using whichever method best fits your environment — direct HTTP calls, a typed TypeScript client, or an MCP server for AI agent integration.

​
🔌 Integration Methods

REST APITypeScript SDKMCP Server
PackageNone (HTTP)@tangogroup/forge-sdk@tangogroup/forge-mcp
Best forAny language, CI/CD scripts, one-off callsTypeScript/JavaScript applications, backend servicesAI agents, LLM tool use, autonomous workflows
AuthBearer token headerConfigured in constructorEnvironment variables
Type safetyNone (bring your own)Full TypeScript typesN/A (MCP protocol)
DependenciesNoneZero (native fetch)@modelcontextprotocol/sdk, zod
EnvironmentsAnywhere with HTTPNode.js, browsers, edge runtimesNode.js (stdio transport)
CoverageAll 42+ endpointsAll endpoints17 tools + 8 resources

​
🎯 Choose Your Integration

REST API

Direct HTTP calls to the Platform API. Use from any language or environment. Full OpenAPI 3.1 spec with auto-generated endpoint documentation.

TypeScript SDK

Zero-dependency typed client for Node.js and browsers. Covers all endpoints with ForgeClient methods, typed responses, and structured error handling.

MCP Server

Model Context Protocol server that exposes Forge capabilities as tools and resources. Lets AI agents read platform state and take actions through their native tool-use interface.

​
⚡ Quick Comparison

​
REST API

Use the REST API when you need maximum flexibility, are working in a non-TypeScript language, or need a single HTTP call from a script or pipeline. 
curl https://forge.gloo.ai/api/v1/agents \
  -H "Authorization: Bearer forge_sk_abc123..."

​
TypeScript SDK

Use the SDK when you are building a TypeScript application and want typed responses, structured errors, and a clean method interface. 
import { ForgeClient } from "@tangogroup/forge-sdk";

const forge = new ForgeClient({
  baseUrl: "https://forge.gloo.ai",
  apiKey: process.env.FORGE_API_KEY!,
});

const { data: agents } = await forge.listAgents();

​
MCP Server

Use the MCP server when you want AI agents to interact with Forge through the Model Context Protocol. The server exposes tools (for actions) and resources (for reads) that agents invoke through their standard tool-use interface. 
{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["@tangogroup/forge-mcp"],
      "env": {
        "FORGE_API_URL": "https://forge.gloo.ai",
        "FORGE_API_KEY": "forge_sk_abc123..."
      }
    }
  }
}

​
🤔 When to Use What

Building a backend service that manages agents, triggers workflows, or queries run status programmatically.Recommended: TypeScript SDKThe SDK gives you typed methods for every endpoint, structured error handling via ForgeApiError, and zero additional dependencies.