
Octocode MCP - AI Context Platform
Octocode MCP provides AI assistants with research-driven development capabilities by connecting to GitHub, GitLab, and local codebases through tools including repository search, code pattern discovery, Language Server Protocol intelligence (Go to Definition, Find References, Call Hierarchy), and file browsing. The server enables AI agents to understand code implementations, explore pull requests, and perform compiler-level code analysis to solve problems that typically require senior engineer expertise. It offers both a core MCP server and modular skills (Researcher, Research, Engineer, and Plan) that support multi-phase investigation, code generation, and evidence-based planning workflows.
- GitHub stars
- 863
- tools
- 17
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 10, 2025
Tools
17 toolsPublic tool metadata for what this MCP can expose to an agent.
ghSearchCodeCode and path search across GitHub by owner, repository, path, filename, extension, and match filters.
Code and path search across GitHub by owner, repository, path, filename, extension, and match filters.
No parameter schema in public metadata yet.
ghGetFileContentRead a GitHub file or region: full file, line range, match slice, or paginated chars.
Read a GitHub file or region: full file, line range, match slice, or paginated chars.
No parameter schema in public metadata yet.
ghViewRepoStructureBrowse a repository's directory tree, plus opt-in repository enrichments.
Browse a repository's directory tree, plus opt-in repository enrichments.
No parameter schema in public metadata yet.
ghSearchReposDiscover repositories by keywords, owner, topic, language, stars, updated, license, visibility.
Discover repositories by keywords, owner, topic, language, stars, updated, license, visibility.
No parameter schema in public metadata yet.
ghSearchPullRequestsSearch pull requests, or deep-read one PR: files, patches, comments, reviews, commits.
Search pull requests, or deep-read one PR: files, patches, comments, reviews, commits.
No parameter schema in public metadata yet.
ghSearchIssuesSearch issues, or read one issue's body and comments.
Search issues, or read one issue's body and comments.
No parameter schema in public metadata yet.
ghSearchCommitsWalk a repository's commit history, or compare two refs (base+head).
Walk a repository's commit history, or compare two refs (base+head).
No parameter schema in public metadata yet.
ghListReleasesList releases and the latest stable release, with opt-in assets.
List releases and the latest stable release, with opt-in assets.
No parameter schema in public metadata yet.
ghSearchDiscussionsSearch a repository's Discussions (Q&A, RFCs, announcements) through GraphQL.
Search a repository's Discussions (Q&A, RFCs, announcements) through GraphQL.
No parameter schema in public metadata yet.
ghCloneRepoClone a repository or sparse subtree into the local cache for local and LSP analysis.
Clone a repository or sparse subtree into the local cache for local and LSP analysis.
No parameter schema in public metadata yet.
localSearchCodeLocal code/text search returning file and line anchors, with structural AST shape queries.
Local code/text search returning file and line anchors, with structural AST shape queries.
No parameter schema in public metadata yet.
localViewStructureBrowse a local directory tree: depth, filters, pagination, metadata.
Browse a local directory tree: depth, filters, pagination, metadata.
No parameter schema in public metadata yet.
localFindFilesFind local files and directories by name, path, regex, extension, size, time, permissions, type.
Find local files and directories by name, path, regex, extension, size, time, permissions, type.
No parameter schema in public metadata yet.
localFindDeadCodeFind likely-unreferenced exports and dead-code clusters using whole-repository reachability analysis.
Find likely-unreferenced exports and dead-code clusters using whole-repository reachability analysis.
No parameter schema in public metadata yet.
localGetFileContentRead a local file or region: exact slice, match string, line range, or paginated chars.
Read a local file or region: exact slice, match string, line range, or paginated chars.
No parameter schema in public metadata yet.
npmSearchnpm package lookup and keyword search; returns metadata and the source repository for GitHub handoff.
npm package lookup and keyword search; returns metadata and the source repository for GitHub handoff.
No parameter schema in public metadata yet.
lspGetSemanticsTyped semantic navigation: definition, references, callers, callees, hover, document symbols and more via installed language servers.
Typed semantic navigation: definition, references, callers, callees, hover, document symbols and more via installed language servers.
No parameter schema in public metadata yet.
Sponsors
Configuration
GITHUB_TOKENsecretGitHub Personal Access Token. Optional - authenticate via GitHub CLI (gh auth login) for automatic token management, or set this token manually for CI/CD environments.
Readme
Octocode: agentic research platform
Evidence-first code research for AI agents and developers.
Details
- Repository
- github.com/bgauryy/octocode-mcp
- Categories
- Developer Tools, Search & Web Crawling
- Package
octocode-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active