Skip to main content

Igris SDK

The Igris SDK is a thin client that generates MCP configurations with built-in authentication, identity tracking, and audit trail support. It works with any MCP client — Claude Desktop, Cursor, Vercel AI SDK, LangChain, or your own.

What the SDK Does

  1. Generates MCP client configs — URL + headers for any MCP client to consume
  2. Auto-generates trace IDs — correlate multiple tool calls across a single user request
  3. Passes user identity — track who is calling what for governance and audit
  4. Manages resources — list connections, policies, and audit events via API

What the SDK Does NOT Do

  • It does not implement an MCP client — use any existing MCP client library
  • It does not manage upstream credentials — those are stored encrypted in connections
  • It does not evaluate policies — that happens at the gateway

Packages

LanguagePackageRegistry
TypeScript@igris/sdknpm
Pythonigris-sdkPyPI (coming soon)

Quick Example

import { Igris } from "@igris/sdk";

const igris = new Igris({ apiKey: "ig_..." });

// Generate config for any MCP client
const config = igris.getMcpConfig("vk_github_prod", {
  user: "alice@company.com",
  metadata: { role: "developer", team: "engineering" },
});

// Plug into any MCP client
const client = new McpClient({
  transport: new StreamableHttpTransport(config.url, {
    headers: config.headers,
  }),
});

How It Works

Installation

Install the SDK and initialize the client.

Connections

Create and manage encrypted credential vaults.

Identity & Metadata

Pass user identity and metadata for governance.

MCP Client Config

Generate configs for Claude Desktop, Cursor, and more.