Sourcegraph MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Sourcegraph MCP or direct API to search code, fetch repository data, analyze diffs, and review pull requests through natural language.

Sourcegraph logoSourcegraph
Api Key

Sourcegraph is a code intelligence platform for searching, understanding, and managing code across large-scale repositories. It helps developers find, review, and analyze code quickly, boosting productivity and collaboration.

8 Tools

Try Sourcegraph now

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

TOOL ROUTER PLAYGROUND
Sourcegraph
Try asking
TOOLS

Supported Tools

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

Check Site Settings Edit Permission

Tool to check whether site settings can be edited through the API.

Compare Commits

Tool to compare two commits in a repository and retrieve their file diffs.

Get Commit Details

Get detailed information about a specific commit in a repository.

Get Current User

Tool to retrieve information about the currently authenticated user.

Get File Contents

Tool to fetch the contents of a specified file on the default branch.

List Repositories

Tool to list repositories on the Sourcegraph instance.

List Repository Files

Tool to list all files and directories in a repository path.

List repository languages

Tool to list languages used in a repository.

SETUP GUIDE

Connect Sourcegraph MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["sourcegraph"],
  mcp: true,
});
Create a session scoped to Sourcegraph and read its MCP URL and headers
3

Connect your agent to the MCP server

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

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all repositories containing Python code",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Sourcegraph request
SETUP GUIDE

Connect Sourcegraph API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["sourcegraph"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Sourcegraph
3

Run Sourcegraph tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all repositories containing Python code" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Sourcegraph tool calls through the session, and print the final answer

Why Use Composio?

AI Native Sourcegraph Integration

  • Supports both Sourcegraph MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for searching, querying, and managing Sourcegraph code data

Managed Auth

  • Built-in API key handling for Sourcegraph access
  • Central place to manage, scope, and revoke Sourcegraph credentials
  • Per user and per environment keys instead of hard-coding them in code

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 Sourcegraph
  • Scoped, least privilege access to Sourcegraph resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Sourcegraph 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 Sourcegraph.It takes 30 seconds.

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

Start building