gread MCP server
Provides AI agents with access to the source code and documentation of any public GitHub repository.
Also known as NitroRCr/gread
- Stars
- 65
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Jul 5, 2026
- License
- Apache-2.0
What is gread MCP?
gread provides AI agents with access to the source code and documentation of any public GitHub repository.
Summary generated from the project's README
About gread MCP server
Gread allows AI agents to interact with the source code and documentation of any public GitHub repository. It functions as both an MCP server and a skill, making it compatible with various AI chat applications and coding assistants. Users can connect via a streamable HTTP URL for MCP clients or use a specific command to add it as a skill for tools like Cursor, Copilot, OpenCode, or Codex.
This tool automatically identifies documentation repositories and provides them alongside the main codebase when a repository is accessed. Developers can integrate it into their workflow using the provided JSON configuration for MCP or by running the npx skills add command. It is designed to be ready to use immediately upon installation without complex setup requirements.
What you can do with it
- 1Analyze public codebasesAsk an AI agent to explain the logic or structure of a specific public GitHub repository.
- 2Integrate documentation with codeRequest that an AI agent reviews both the source code and the official documentation of a project simultaneously.
- 3Enhance coding assistant capabilitiesAdd repository access to your existing coding environment like Cursor or Copilot.
Written from the project's README. Every use case is checked against a quote from it.
How to install gread MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall gread MCP in Claude Code
$ claude mcp add --transport http gread https://api.gread.dev/mcpInstall gread MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gread": {
"url": "https://api.gread.dev/mcp"
}
}
}Install gread MCP in VS Code
.vscode/mcp.json
{
"servers": {
"gread": {
"type": "http",
"url": "https://api.gread.dev/mcp"
}
}
}Install gread MCP in VS Code CLI
$ code --add-mcp '{"name":"gread","type":"http","url":"https://api.gread.dev/mcp"}'Install gread MCP in Codex
$ codex mcp add gread --url https://api.gread.dev/mcpInstall gread MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.gread] url = "https://api.gread.dev/mcp"
Install gread MCP in Gemini CLI
$ gemini mcp add -s user --transport http gread https://api.gread.dev/mcpInstall gread MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gread": {
"url": "https://api.gread.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablenitrorcr/gread is public and reachablegithub.com/nitrorcr/gread ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-05github.com/nitrorcr/gread ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 773 msPass
README
View on GitHubGread
A skill that gives your agent access to the source code of all public github repos.
- Plug and Play: Compatible with all popular coding agents and MCP clients, ready to use out of the box
- Skill and MCP: Both Skill and MCP are provided, connect with either option
- Docs Integration: Automatically recognizes docs repo and provides them along with the main repo when accessed
Quick Start
We offer two integration methods, choose either one:
- Skill: Suitable for coding agents like OpenCode, Codex, Cursor, Copilot, etc.
- MCP: Suitable for AI chat apps and other MCP clients
Skill
Run the following command to install:
npx skills add https://github.com/NitroRCr/gread --skill gread
MCP
Streamable HTTP URL:
https://api.gread.dev/mcp
JSON configuration reference:
{
"mcpServers": {
"gread": {
"type": "streamableHttp",
"url": "https://api.gread.dev/mcp"
}
}
}
More Information
You can visit our Homepage, view SKILL.md, or directly add Gread and ask your Agent for more information!
Development
Install dependencies:
bun install
Dev server:
bun dev
Dev docs:
bun docs:dev
Community Links
gread MCP questions
How do I add gread MCP to Claude Code?
Run claude mcp add --transport http gread https://api.gread.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add gread MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I use gread with coding agents?
You can install it as a skill using the npx command for agents like Cursor, Copilot, or OpenCode.
How do I connect gread to an MCP client?
You can connect via a streamable HTTP URL provided in the configuration.
Does gread include documentation?
Yes, the server automatically identifies and provides documentation repositories alongside the main repository.