Octocode MCP - AI Context Platform

Evidence-first code research for AI agents and developers. Octocode researches your local code and external code alike (GitHub repositories, PRs, npm) with one toolset: ripgrep + AST search, trees, precise reads, and LSP. Use it as a CLI or MCP server, backed by a Rust engine for fast, token-efficient results across single files or mega-repos. Its 17 documented tools cluster into gh search code, gh get file content, gh view repo structure, gh search repos.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-18 · ★ 920 · #13 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Octocode MCP - AI Context Platform

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add bgauryy-octocode-mcp -- npx -y octocode-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "bgauryy-octocode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "octocode-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package octocode-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.bgauryy is GitHub-verified and matches the repo owner

03 · What Octocode MCP - AI Context Platform can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can read a GitHub file or region: full file, line range, match slice, or paginated chars, browse a repository's directory tree, plus opt-in repository enrichments, discover repositories by keywords, owner, topic, language, stars, updated, license, visibility, and search pull requests, or deep-read one PR: files, patches, comments, reviews, commits.

Capability map

Tools grouped from the project's README - what Octocode MCP - AI Context Platform lets an agent do.

Gh Search Code

1 tool - e.g. Code and path search across GitHub by owner, repository, path, filename, extension, and match filters. Accepts 1 to 5 parallel queries.

ghSearchCode

Gh Get File Content

1 tool - e.g. Read a GitHub file or region: full file, line range, match slice, or paginated chars.

ghGetFileContent

Gh View Repo Structure

1 tool - e.g. Browse a repository's directory tree, plus opt-in repository enrichments.

ghViewRepoStructure

Gh Search Repos

1 tool - e.g. Discover repositories by keywords, owner, topic, language, stars, updated, license, visibility.

ghSearchRepos

Gh Search Pull Requests

1 tool - e.g. Search pull requests, or deep-read one PR: files, patches, comments, reviews, commits.

ghSearchPullRequests

Gh Search Issues

1 tool - e.g. Search issues, or read one issue's body and comments.

ghSearchIssues

Gh Search Commits

1 tool - e.g. Walk a repository's commit history, or compare two refs (base+head).

ghSearchCommits

Gh List Releases

1 tool - e.g. List releases and the latest stable release, with opt-in assets. Opt-in (see Tools for the flags).

ghListReleases

Latest releases

9.1.1 · 2025-12-15

add releases workflow

9.1.0 · 2025-12-15

Changelog - PR #236: Build System Modernization · [Unreleased] · "9.1.0" · Added · Standalone Binary Distribution - Pre-compiled binaries for all major platforms without Node.js dependency · - macOS (Apple Silicon &…

8.0.0 · 2025-11-26

CHANGELOG - Octocode MCP v8.0.0 · > TL;DR: Major release introducing local filesystem research capabilities, new license model, and enhanced prompt commands. · New Features · Local Filesystem Research…

04 · Who maintains Octocode MCP - AI Context Platform

Octocode MCP - AI Context Platform is maintained by bgauryy. It's the only MCP server we track from this author; the repo dates to Jun 2025.

05 · Facts

repository: github.com/bgauryy/octocode-mcp
category: other - ranked #13 of 848 actively-maintained other servers as of 2026-08-25.
registry: io.github.bgauryy/octocode-mcp (active, first published 2025-11-10)
packages: npm:octocode-mcp

06 · Octocode MCP - AI Context Platform FAQ

Is Octocode MCP - AI Context Platform still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-18. We re-verify nightly.

What can Octocode MCP - AI Context Platform do?

How do I install Octocode MCP - AI Context Platform?

Run `npx -y octocode-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Octocode MCP - AI Context Platform run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Octocode MCP - AI Context Platform

Alternatives to Octocode MCP - AI Context Platform

Maintained other servers if Octocode MCP - AI Context Platform isn't the fit.

More MCP servers to compare · Intercept · Codemunch Pro · Bimwright · Displaybuddy MCP · psyXe MCP Server

More TypeScript MCP servers · Context Awesome · Bingowon MCP Server · EasyEDA Copilot · KiCad Copilot · see all