Octocode MCP
An MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens
- 961 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads local files and reaches GitHub over the network
- May use a GitHub token
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/octocodeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads local files and reaches GitHub over the network
- May use a GitHub token
This is third-party code. Review the repository files before installing.
What it does
Octocode gives an agent one toolset for code research: ripgrep and AST search, file trees, precise reads of fragments and work through LSP. It handles both local code and external sources: GitHub repositories, pull requests and npm packages. A Rust engine underneath keeps results fast and token-efficient even on large repos. You use it as a CLI in the terminal or as an MCP server inside an agent, with the same tools and engine in both. GitHub authentication is optional but unlocks private repos and higher API limits.
Who it is for. For developers who want an agent to understand their own and others' code before changing anything.
Good fit when
- You need to find how something works in a large repo
- You need to research a third-party project or package on GitHub
- You want to save tokens on code exploration
Not a fit when
- You need a full editor that changes code, not research
- The project is small and the agent's built-in search is enough
Example request
Use octocode to find where this repo handles authentication and show the key filesMCP
- Transport
- stdio
- Authentication
- key is optional
Environment variables
GITHUB_TOKENsecret- GitHub token for private repos and higher API limits, optional
Limitations
Without a GitHub token only public repos work and base API limits apply. Private code and higher limits need authentication. The main use is reading and researching code, not editing it.
How to disable. Remove the octocode server from your MCP config or uninstall the CLI package.
FAQ
Do I need a GitHub token?
Not for public code. For private repos and higher limits, sign in with npx octocode auth login.
Is it a CLI or MCP?
Both: the same toolset and engine are available as a terminal CLI and as an MCP server.
Discussion
No questions or reviews yet.
Related
MCP serversA structural code search MCP server for agents: finds the right file by query intent and runs locally
Octocode
octocode
Structural and semantic code search with a knowledge graph in Rust, with an MCP mode for agents. Embeddings need keys, so code goes to the provider
An MCP server that turns a large codebase into a semantic feature graph for precise navigation and meaning-based search
An MCP server that indexes code with tree-sitter so an agent reads single symbols, not files, traces paths and weighs edits
codesearch searches code across several repositories with hybrid retrieval and runs fully offline, without a GPU or Docker.
An MCP server that indexes code with tree-sitter and returns individual functions and classes to the agent instead of whole files
README in short
The README describes Octocode as a code research tool for agents and developers that spans local code and GitHub with one toolset. Underneath is a Rust engine with ripgrep and AST search, trees, precise reads and LSP. It is available as a CLI and an MCP server, with one-click install for popular clients. GitHub auth is optional and expands what it can reach. MIT licensed.