Providers
Providers
Integrate NIN Connect tools into your AI agent framework — Vercel AI SDK, OpenAI Agents SDK, or Claude.
Overview
NIN Connect tools work with any AI agent framework. The SDK returns tool definitions with names, descriptions, and JSON Schema inputs — the same format every major framework expects.
The pattern is always the same:
- Fetch tool definitions with
session.getTools() - Map them into your framework's tool format
- Let the LLM decide which tools to call
- Execute via
session.execute()— NIN handles auth
Supported Frameworks
Quick Comparison
| Framework | Tool Format | Agent Loop |
|---|---|---|
| Vercel AI SDK | tool() with inputSchema: jsonSchema() + execute | Built-in via generateText with stopWhen |
| OpenAI Agents SDK | { type: "function", name, description, parameters, execute } | Built-in via run() |
| Claude Agents SDK | { name, description, input_schema } | Manual loop checking stop_reason === "tool_use" |
Fetch Tools
All integrations start the same way:
import { Nin } from "@nin.in/core";
const nin = new Nin({ apiKey: process.env.NIN_API_KEY! });
const session = nin.session("user_123");
const toolDefs = await session.getTools({ plugins: ["gmail", "slack"] });Each toolDef has:
slug— tool identifier (e.g.GMAIL_SEND_EMAIL)description— what it does (shown to the LLM)inputSchema— JSON Schema for parameters (the LLM uses this to generate arguments)