octocode
Code research platform for AI agents; find, understand, and prove context across your code and all of GitHub, in a fraction of the tokens. One toolset, MCP or CLI
Octocode is an MCP server and CLI tool that provides evidence-based code research capabilities for AI agents. It enables agents to search, navigate, and analyze both local codebases and external GitHub repositories using a unified toolkit of 17 tools including ripgrep, AST search, LSP navigation, and token-efficient file reading. Built on a Rust engine, it delivers fast searches across monorepos while minimizing token usage through smart pagination, minification, and skeletal code views. Agents can trace implementation patterns across repositories, follow pull requests, analyze dependencies, and perform semantic navigation without token bloat.
Key Features
Use Cases
- 01Research implementation patterns across multiple GitHub repositories before writing new code
- 02Navigate large monorepos efficiently with AST-based searches and LSP semantic queries
- 03Review pull requests by analyzing file changes, patches, comments, and related commits
- 04Trace function definitions, references, and call hierarchies across a codebase using LSP
- 05Find dead code and unreferenced exports through whole-repository reachability analysis
- 06Compare how different projects solve similar problems by searching code across GitHub and npm packages
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
octocode — FAQ
What is Octocode?+
Octocode is an MCP server and CLI tool that provides AI agents with token-efficient code research capabilities across local files and GitHub repositories. It offers 17 tools including code search, AST pattern matching, LSP navigation, and file reading with automatic minification.
How do I install Octocode as an MCP server?+
Add Octocode to your MCP client config with command 'npx', args ['octocode-mcp@latest'], and type 'stdio'. One-click installers are available for Cursor, VS Code, Windsurf, and other MCP clients. Optionally set OCTOCODE_TOKEN in the env section for GitHub access.
Which AI clients work with Octocode?+
Octocode works with any MCP-compatible client including Cursor, VS Code, Windsurf, Claude Desktop, Kiro, Goose, LM Studio, and Claude Code. It can also be used directly as a CLI tool without an MCP client.
Do I need a GitHub API key?+
GitHub authentication is optional but recommended—it unlocks private repositories and higher API rate limits. You can authenticate using 'npx octocode auth login', the GitHub CLI ('gh auth login'), or by setting OCTOCODE_TOKEN, GH_TOKEN, or GITHUB_TOKEN environment variables with a personal access token.
Is Octocode free to use?+
Yes, Octocode is open source and free to use. GitHub API access follows GitHub's rate limits (higher with authentication). The tool runs locally with prebuilt Rust binaries and requires no additional subscriptions.
What are the prerequisites for using Octocode?+
Octocode requires Node.js 20.12 or higher. For LSP features, you may need to install language servers for your target languages. No Rust toolchain is required at runtime since prebuilt binaries are included for macOS, Linux, and Windows.
How do I install octocode?+
Open the source repository on GitHub and follow its README. octocode is a mcp server — MCP Agents Market links you directly to the official repo.
Is octocode free?+
octocode is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.