Summary
Points directly at public GitHub repositories and streams their source code into your AI context. Connect via streamable HTTP at api.gread.dev/mcp and you get read access to any repo's files without cloning or manual downloads. The server automatically detects and includes documentation repositories when you reference a project, so you're not just getting code but the context around it. Useful when you're exploring unfamiliar codebases, need to reference implementation details from dependencies, or want your AI to understand how a library actually works under the hood. No local setup required since it runs as a remote service.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Public tool metadata for what this MCP can expose to an agent.
5 tools
search_reposSearch for GitHub repositories by name, description, or topic keywords using the GitHub Search API.1 params
Search for GitHub repositories by name, description, or topic keywords using the GitHub Search API.
Parameters* required
qstringKeyword to search in repository names, descriptions, or topics
view_repoView repository basic information and its directory structure. Includes corresponding documentation repo if available.1 params
View repository basic information and its directory structure. Includes corresponding documentation repo if available.
Parameters* required
namestringFull name of the repository (owner/name)
list_treeList the directory tree of a specific path in a repository with customizable depth and traversal limits.4 params
List the directory tree of a specific path in a repository with customizable depth and traversal limits.
Parameters* required
maxDepthnumberMaximum depth into the directory structure to list.default: 3
maxPerDirnumberMaximum number of items to display per directory level.default: 40
namestringFull name of the repository (owner/name)
targetDirstringTarget directory path to inspect. Leaves empty to search from root.default:
read_codeRetrieve the raw source code of specified files from within a known repository.2 params
Retrieve the raw source code of specified files from within a known repository.
Parameters* required
namestringFull name of the repository (owner/name)
pathsarrayAn array of precise file paths within the repository
search_codePerform a fast git grep inside the repository, allowing regex matching by default or substring search.7 params
Perform a fast git grep inside the repository, allowing regex matching by default or substring search.
Parameters* required
contextLinesnumberPrint num lines of output context (-C)
extendedRegexpbooleanUse extended regular expressions (-E)
fixedStringsbooleanUse fixed strings for patterns (don’t interpret pattern as a regex) (-F)
ignoreCasebooleanIgnore case distinctions in both the PATTERN and the input files (-i)
namestringFull name of the repository (owner/name)
pathstringDirectory or file path to limit the search scope
querystringSearch pattern or query to pass to git grep
Gread
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
