Skip to content

Document result limits for MCP tools #1395

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 29, 2025
Merged

Document result limits for MCP tools #1395

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
325e16f
Document result limits for MCP tools
janhartman Oct 29, 2025
a22dbb3
Revert accidental change
janhartman Oct 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/api/mcp/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
</TierCallout>
<Callout type="note">Available in version 6.8 and above</Callout>
<Callout type="note">Available in version 6.8 and above.</Callout>
<Callout type="note">This feature is [experimental](admin/beta_and_experimental_features#experimental-features) and might change or be removed in the future.</Callout>

The Sourcegraph Model Context Protocol (MCP) Server provides AI agents and applications with programmatic access to your Sourcegraph instance's code search, navigation, and analysis capabilities through a standardized interface.
Expand Down Expand Up @@ -134,6 +134,10 @@ Locally-scoped servers take precedence over project-scoped servers with the same

## Available Tools

<Callout type="info">
All MCP tools implement result limits to ensure efficient operation and prevent context window overflow. These limits are designed to return the most relevant results while maintaining optimal performance. For large result sets, use pagination parameters (`after`/`before` cursors) where available, or refine your search with more specific filters.
</Callout>

The MCP server provides these tools for code exploration and analysis:

### File & Repository Operations
Expand Down Expand Up @@ -188,10 +192,6 @@ Perform exact keyword searches with boolean operators and filters.

**Features:** Boolean AND/OR operators, regex patterns

<Callout type="info">
The `sg_keyword_search` MCP tool currently returns structured content wrapped in an extra content field. This mismatch can trigger validation errors in strict MCP clients, such as the Python MCP client. A fix is planned for a future release; for now, affected clients can manually unwrap the content field as a workaround.
</Callout>

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This has been fixed and is no longer necessary

#### `sg_nls_search`

Semantic search with flexible linguistic matching.
Expand Down