For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://modelgates.ai/docs/_mcp/server.
TypeScript SDK
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.
The ModelGates TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.
Why use the ModelGates SDK?
Integrating AI models into applications involves handling different provider APIs, managing model-specific requirements, and avoiding common implementation mistakes. The ModelGates SDK standardizes these integrations and protects you from footguns.
import ModelGates from '@modelgates/sdk'; const client = new ModelGates({ apiKey: process.env.MODELGATES_API_KEY}); const response = await client.chat.send({ model: "minimax/minimax-m2", messages: [ { role: "user", content: "Explain quantum computing" } ]});The SDK provides three core benefits:
Auto-generated from API specifications
The SDK is automatically generated from ModelGates's OpenAPI specs and updated with every API change. New models, parameters, and features appear in your IDE autocomplete immediately. No manual updates. No version drift.
// When new models launch, they're available instantlyconst response = await client.chat.send({ model: "minimax/minimax-m2",});Type-safe by default
Every parameter, response field, and configuration option is fully typed. Invalid configurations are caught at compile time, not in production.
const response = await client.chat.send({ model: "minimax/minimax-m2", messages: [ { role: "user", content: "Hello" } // ← Your IDE validates message structure ], temperature: 0.7, // ← Type-checked stream: true // ← Response type changes based on this});Actionable error messages:
// Instead of generic errors, get specific guidance:// "Model 'openai/o1-preview' requires at least 2 messages.// You provided 1 message. Add a system or user message."Type-safe streaming:
const stream = await client.chat.send({ model: "minimax/minimax-m2", messages: [{ role: "user", content: "Write a story" }], stream: true}); for await (const chunk of stream) { // Full type information for streaming responses const content = chunk.choices[0]?.delta?.content;}Installation
npm install @modelgates/sdkGet your API key from modelgates.ai/settings/keys.
Quick start
import ModelGates from '@modelgates/sdk'; const client = new ModelGates({ apiKey: process.env.MODELGATES_API_KEY}); const response = await client.chat.send({ model: "minimax/minimax-m2", messages: [ { role: "user", content: "Hello!" } ]}); console.log(response.choices[0].message.content);