Gist MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Gist MCP or direct API to create new gists, fetch and summarize existing gists, update shared code, and manage gist privacy settings through natural language.

Gist logoGist
Api Key

GitHub Gist is a service for sharing code snippets and notes. It makes it easy to collaborate and organize your code or text, publicly or privately.

20 Tools

Try Gist now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Gist
Try asking
TOOLS

Supported Tools

Every Gist action and event your agent gets out of the box.

Check Gist Star

Check if the authenticated user has starred a specific gist.

Create Gist

Tool to create a new gist with one or more files.

Create Gist Comment

Tool to create a comment on a gist.

Delete Gist

Tool to delete a gist.

Delete Gist Comment

Tool to delete a comment on a gist.

Fork Gist

Tool to fork a gist.

Get Gist

Tool to retrieve a specific gist by its ID.

Get Gist Comment

Tool to get a specific comment on a gist.

Get Gist Revision

Tool to retrieve a specific gist revision.

List Gist Comments

Tool to list comments on a gist.

List Gist Commits

Tool to list the commit history of a gist.

List Gist Forks

Tool to list forks of a gist.

List Gists

Tool to list the authenticated user's gists or all public gists if called anonymously.

List Public Gists

Tool to list public gists sorted by most recently updated.

List Starred Gists

Tool to list the authenticated user's starred gists.

List User Gists

Tool to list public gists for a specified GitHub user.

Star a Gist

Star a GitHub gist.

Unstar a Gist

Unstar a GitHub gist.

Update Gist

Tool to update a gist's description and files.

Update Gist Comment

Tool to update a Gist comment.

SETUP GUIDE

Connect Gist MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List all my public gists' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Gist API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Gist Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all my public and private gists'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Gist actions with your Agent

Why Use Composio?

AI Native Gist Integration

  • Supports both Gist MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Gist data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke Gist access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Gist
  • Scoped, least privilege access to Gist resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Gist requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Gist.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Gist tool your agent needs.Free to start.

Start building