About Octocode MCP - AI Context Platform
Octocode MCP - AI Context Platform is an MCP server in the Search category: aI code research platform. Search, analyze, and extract insights from any GitHub repository.
Install
claude mcp add octocode-mcp-ai-context-platform -- npx -y octocode-mcpnpx -y octocode-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
ghCloneRepoClone a repository or sparse subtree into the local cache for local and LSP analysis. **Opt-in** on MCP (`ENABLE_CLONE=true`); on by default in the CLI.
Parameters not published.
ghGetFileContentRead a GitHub file or region: full file, line range, match slice, or paginated chars.
Parameters not published.
ghListReleasesList releases and the latest stable release, with opt-in assets. **Opt-in** (see [Tools](#tools) for the flags).
Parameters not published.
ghSearchCodeCode and path search across GitHub by owner, repository, path, filename, extension, and match filters. Accepts 1 to 5 parallel queries.
Parameters not published.
ghSearchCommitsWalk a repository's commit history, or compare two refs (`base`+`head`).
Parameters not published.
ghSearchDiscussionsSearch a repository's Discussions (Q&A, RFCs, announcements) through GraphQL. **Opt-in** (see [Tools](#tools) for the flags).
Parameters not published.
ghSearchIssuesSearch issues, or read one issue's body and comments.
Parameters not published.
ghSearchPullRequestsSearch pull requests, or deep-read one PR: files, patches, comments, reviews, commits.
Parameters not published.
ghSearchReposDiscover repositories by keywords, owner, topic, language, stars, updated, license, visibility.
Parameters not published.
ghViewRepoStructureBrowse a repository's directory tree, plus opt-in repository enrichments.
Parameters not published.
Ask AI
Ask AI about Octocode MCP - AI Context Platform
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
Octocode: Research Driven Development for AI
Installation
Prerequisites: GitHub authentication required. See Authentication Setup.
Recommended: Octocode CLI
npx octocode-cli install
Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace. Pass --ide <ide> for non-interactive install (e.g. npx octocode-cli install --ide cursor).
Alternative Methods
Add to your MCP configuration file:
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": ["octocode-mcp@latest"]
}
}
}
npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research
MCP Server
The Octocode MCP Server connects your AI assistant to code:
- GitHub & GitLab: Search repositories, find usage patterns, read implementations, explore PRs
- Local Tools: Search code, browse directories, find files in your local codebase
- LSP Intelligence: Go to Definition, Find References, Call Hierarchy -- compiler-level understanding
https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071
Skills
Agent Skills are a lightweight, open format for extending AI agent capabilities. Skills index: skills/README.md
| Skill | What it does |
|---|---|
| Researcher | Code search & exploration — local LSP + external (GitHub, npm/PyPI) |
| Research | Multi-phase research with sessions, checkpoints, state persistence |
| Engineer | Understand, write, analyze, audit code — AST + LSP + dependency graph |
| Plan | Evidence-based planning: Understand > Research > Plan > Implement |
| RFC Generator | Formal technical decisions with alternatives, trade-offs, and recommendations |
| PR Reviewer | PR & local code review across 7 domains with LSP flow tracing |
| Roast | Brutal code critique with file:line citations and severity levels |
| Prompt Optimizer | Turn weak prompts into enforceable agent protocols |
| Doc Writer | 6-phase pipeline producing 16+ validated docs |
https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec
Documentation
For the full documentation index, start here: docs/README.md
Recommended quick links:
- Authentication Setup
- Configuration Reference
- Local Tools + LSP Reference
- CLI Skills Guide
- Skills Index
- Troubleshooting
The Manifest
"Code is Truth, but Context is the Map." -- Read the Manifest for Research Driven Development to understand the philosophy behind Octocode.
Contributing
See the Development Guide for monorepo setup, testing, and contribution guidelines.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.