io.github.NitroRCr/gread

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

An MCP server that gives your AI access to the source code and docs of all public github repos

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "gread": {
      "url": "https://api.gread.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• search_repos

  Search for GitHub repositories by name, description, or topic keywords using the GitHub Search API.

  Parameters:

  • q (required) — string — Keyword to search in repository names, descriptions, or topics

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• view_repo

  View repository basic information and its directory structure. Includes corresponding documentation repo if available.

  Parameters:

  • name (required) — string — Full name of the repository (owner/name)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_tree

  List the directory tree of a specific path in a repository with customizable depth and traversal limits.

  Parameters:

  • name (required) — string — Full name of the repository (owner/name)
  • maxDepth — number — Maximum depth into the directory structure to list.
  • maxPerDir — number — Maximum number of items to display per directory level.
  • targetDir — string — Target directory path to inspect. Leaves empty to search from root.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• read_code

  Retrieve the raw source code of specified files from within a known repository.

  Parameters:

  • name (required) — string — Full name of the repository (owner/name)
  • paths (required) — array — An array of precise file paths within the repository

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_code

  Perform a fast git grep inside the repository, allowing regex matching by default or substring search.

  Parameters:

  • name (required) — string — Full name of the repository (owner/name)
  • query (required) — string — Search pattern or query to pass to git grep
  • path — string — Directory or file path to limit the search scope
  • ignoreCase — boolean — Ignore case distinctions in both the PATTERN and the input files (-i)
  • contextLines — number — Print num lines of output context (-C)
  • fixedStrings — boolean — Use fixed strings for patterns (don’t interpret pattern as a regex) (-F)
  • extendedRegexp — boolean — Use extended regular expressions (-E)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.