Gread

nitrorcr/gread

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.

GitHub stars: 54
tools: 5
transport: HTTP
last updated: May 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.gread.dev/mcp --name gread

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http gread https://api.gread.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 5 tools

Verified live against the running server on Nov 6, 2026.

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

q*string

Keyword 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

name*string

Full 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

maxDepthnumber

Maximum depth into the directory structure to list.default: 3

maxPerDirnumber

Maximum number of items to display per directory level.default: 40

name*string

Full name of the repository (owner/name)

targetDirstring

Target 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

name*string

Full name of the repository (owner/name)

paths*array

An 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

contextLinesnumber

Print num lines of output context (-C)

extendedRegexpboolean

Use extended regular expressions (-E)

fixedStringsboolean

Use fixed strings for patterns (don’t interpret pattern as a regex) (-F)

ignoreCaseboolean

Ignore case distinctions in both the PATTERN and the input files (-i)

name*string

Full name of the repository (owner/name)

pathstring

Directory or file path to limit the search scope

query*string

Search pattern or query to pass to git grep

Readme

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:

View the full README on GitHub

Details

Repository: github.com/nitrorcr/gread
Category: Developer Tools
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Developer Tools MCP servers

View all

Akbdnotitia/akbGit-backed org memory for AI agents — hybrid search, tables, files & a URI graph over MCP.52stars

Kindexwandercom/kindexPersistent knowledge graph and MCP server for AI workflows with git-tracked project context.49stars

Palinodephasespace-labs/palinodeInspectable, correctable project memory in git-versioned Markdown for AI agents.46stars

Saga Mcpspranab/saga-mcpJira-like project tracker for AI agents with SQLite, full task hierarchy, and dashboard42stars

Code Memorykapillamba4/code-memoryLocal semantic code search with Git history. Works offline, no API key needed.41stars

Seekstoneshaqmughal/seekstoneFilesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.35stars