runstack-tools

Runstack meta-tools for the Vercel AI SDK. Drop 600+ connector tools (GitHub, Notion, Gmail, Linear, Google Sheets, Google Calendar, …) into any agentic workflow with one line.

📚 Docs: https://docs.runstack.engineer/docs/ai-sdk

Backed by the Runstack — your agent gets a discover - authenticate - execute loop that scales to every tool in the Runstack registry without bloating your model's context window.

Install

npm install runstack-tools ai zod

Get an API key (rsk_…) at app.runstack.engineer.

Usage

All connectors

import { generateText } from 'ai';
import { runstackTools } from 'runstack-tools';

await generateText({
  model: 'anthropic/claude-sonnet-4-5',
  prompt: 'Star the vercel/ai repo on GitHub and email me a confirmation.',
  tools: runstackTools(process.env.RUNSTACK_API_KEY!),
});

Scoped to a single connector

When you only need one connector, scope search_tools to it. All 4 meta tools are still returned so the agent can authenticate and execute as needed.

tools: runstackTools('github', process.env.RUNSTACK_API_KEY!)

Supported connectors: github, notion, gmail, linear, google-sheets, googlecalendar.

How it works

runstackTools() returns four AI SDK tool() definitions:

| Tool | Purpose | | --------------------- | ------------------------------------------------------------- | | search_tools | Discover tools by regex over names and descriptions | | check_authentication| Verify the user has connected the required provider | | initiate_connection | Get an OAuth link for the user to connect a provider | | execute_tool | Run any discovered tool with type-coerced arguments |

Each call is forwarded as a JSON-RPC tools/call request to the Runstack MCP server (https://app.runstack.engineer/mcp) with your API key.

Options

runstackTools(apiKey, { endpoint: 'https://your-self-hosted.example.com/mcp' })
runstackTools('github', apiKey, { endpoint: '…' })

Learn more

• Full documentation
• Runstack MCP server
• Meta tools reference
• API keys

License

MIT