Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.igrisecurity.com/llms.txt

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

​
Igris SDK

The Igris SDK is a thin client that generates MCP configurations and speaks JSON-RPC to the gateway directly when you’d rather call tools programmatically. It works with any MCP client — Claude Desktop, Cursor, Vercel AI SDK, LangChain, or your own — and also exposes its own igris.mcp resource for direct tool invocation.

​
What the SDK Does

  1. Generates MCP client configs — URL + headers for any external MCP client to consume (igris.connectHttp)
  2. Calls MCP tools directly — igris.mcp.initialize, listTools, callTool over the gateway, no extra dependencies
  3. Auto-generates trace IDs — correlate multiple tool calls across a single user request
  4. Passes user identity — track who is calling what for governance and audit
  5. Manages resources — list connections, policies, and audit events via API

​
What the SDK Does NOT Do

  • It does not run a stdio MCP transport — only HTTP/SSE gateway connections are supported in the product today
  • 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-security/sdknpm

​
Quick Example

Two ways, depending on whether you want to drive an external MCP client or call tools directly. 
import { Igris } from "@igris-security/sdk";

const igris = new Igris({ apiKey: process.env.IGRIS_API_KEY! });

// Option 1 — Generate config for any external MCP client.
const config = igris.connectHttp("github-prod", {
  user: "alice@company.com",
  metadata: { role: "developer", team: "engineering" },
});

const client = new McpClient({
  transport: new StreamableHttpTransport(config.baseUrl, {
    headers: {
      Authorization: `Bearer ${config.apiKey}`,
      ...config.headers,
    },
  }),
});

// Option 2 — Call tools directly via the SDK.
const tools = await igris.mcp.listTools("github-prod", {
  user: "alice@company.com",
});
const output = await igris.mcp.callTool(
  "github-prod",
  "create_branch",
  { repo: "acme/igris", name: "feat/new" },
  { user: "alice@company.com" },
);

​
How It Works

Installation

Install the SDK and initialize the client.

Tool Calls

Call MCP tools programmatically with igris.mcp.

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.