io.github.vanshulgoyal101Published by GitHub account vanshulgoyal101v1.0.0Updated Oct 24, 2026
Turn a GitHub repo or docs site into agent-ready context: pack it or search it, over MCP.
Remote MCP server that turns a GitHub repository or documentation site into token-counted context an assistant can pack or search.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.vanshulgoyal101%2Fctx/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"ctx": {
"type": "http",
"url": "https://ctx.vanshul.com/mcp"
}
}
}[MCP Registry] [Endpoint] [License: MIT]
A public Model Context Protocol (MCP) server, running as a Cloudflare Worker, that turns a GitHub repository or a documentation site into agent-ready context. Point an AI agent at it and it can pack a whole repo (or crawl a docs site) into one token-counted blob — or search it and get back only the relevant passages, each with its file/URL and line.
It's the agent-first companion to mcp/: where mcp reads a single
web page, ctx reads whole repos and doc sites. The repo pipeline fetches,
gunzips and parses the tarball in-process; docs extraction reuses Mozilla
Readability + Turndown.
repo is owner/repo, owner/repo/ref, or a github.com URL. url (for the
docs tools) is an absolute http(s) docs page to start crawling from.
Stdio-only clients bridge with npx mcp-remote https://ctx.vanshul.com/mcp.
~/.cursor/mcp.json:
claude_desktop_config.json (Settings → Developer → Edit Config). If your version is stdio-only, use:
ctx with URL https://ctx.vanshul.com/mcp to your MCP servers config.The GitHub URL is always constructed from a fixed owner/repo slug, so the repo
tools have no SSRF surface. The docs tools fetch caller-supplied URLs, so every
URL and redirect hop is re-validated against the SSRF guard. Downloads are
bounded (timeout, size caps, page/file-count caps) and results are cached
per-isolate for a few minutes.
Set a GITHUB_TOKEN Worker secret to lift GitHub's rate limit (60 → 5,000/hour) and
read private repos:
The token is a Worker secret only — never a tool argument — so it can't leak to an agent.
MIT © Vanshul Goyal
Source: README.md at commit 5860b7c
Fetch a GitHub repository and return it as one agent-ready context blob: text files concatenated with clear "==== path ====" headers, binaries/lockfiles/build dirs stripped, with a token estimate. Use include/exclude globs to focus, and max_tokens to fit a budget.
refreporequiredexcludeincludemax_tokensSearch a GitHub repository and return only the passages that match a query — each with its file path, line number and a relevance score. Far more token-efficient than pack_repo when you need a specific detail (e.g. "where is auth handled?").
refreporequiredqueryrequiredexcludeincludemax_matchescontext_charsList the text files ctx would include for a repository (after stripping binaries, lockfiles and build dirs), with their byte sizes. Cheap way for an agent to see the layout before packing.
refreporequiredexcludeincludeReturn the full text of a single file in a repository, by path. Use after list_files or search_context to drill in.
refpathrequiredreporequiredCrawl a documentation site from a start URL and return it as one agent-ready context blob: each page extracted to clean Markdown, concatenated with its URL. Stays within the same site section; bounded by depth and page count. Use max_tokens to fit a budget.
urlrequireddepthmax_pagesmax_tokensCrawl a documentation site and return only the passages that match a query — each with its page URL, line and a relevance score. Token-efficient way to answer a question from docs without packing the whole site.
urlrequireddepthqueryrequiredmax_pagesmax_matchescontext_chars100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
POST https://ctx.vanshul.com/mcp # JSON-RPC 2.0 (MCP)GET https://ctx.vanshul.com/health # { ok: true, tools: [...] }{ "mcpServers": { "ctx": { "url": "https://ctx.vanshul.com/mcp" } } }{ "mcpServers": { "ctx": { "url": "https://ctx.vanshul.com/mcp" } } }{ "mcpServers": { "ctx": { "command": "npx", "args": ["mcp-remote", "https://ctx.vanshul.com/mcp"] } } }# Pack a repo, capped to 8000 tokenscurl -s https://ctx.vanshul.com/mcp -H 'content-type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"pack_repo","arguments":{"repo":"sindresorhus/slugify","max_tokens":8000}}}'
# Search a repo for just the relevant passagescurl -s https://ctx.vanshul.com/mcp -H 'content-type: application/json' \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"search_context","arguments":{"repo":"sindresorhus/slugify","query":"replace separator"}}}'ctx/├── src/│ ├── worker.ts # entry: routes /mcp, /health, rate limit, CORS│ ├── mcp.ts # JSON-RPC dispatch + the six tool definitions│ ├── github.ts # fetch tarball, gunzip, parse tar, filter files (no deps)│ ├── pack.ts # assemble the context blob + token estimate│ ├── search.ts # ranked passage search over files (file + line)│ ├── docs.ts # crawl a docs site into pages (BFS, same-section)│ ├── extract.ts # HTML -> Markdown / links (Readability + Turndown)│ ├── fetcher.ts # bounded fetch with re-validated redirects (SSRF)│ └── security.ts # SSRF guard (block private/internal addresses)├── public/│ ├── index.html # landing page (served for non-API paths)│ ├── og.png / og.svg│ ├── robots.txt│ └── sitemap.xml├── tests/ # vitest: github (tar parsing), pack, search, mcp, worker├── docs/ # architecture, tools/API reference, deployment├── wrangler.toml├── package.json└── tsconfig.jsoncd ctxnpm installnpm run typechecknpm test # vitest — full suitenpm run dev # local worker at http://localhost:8787 (POST /mcp)npm run deploy # wrangler deployowner/repo → github.com tarball → DecompressionStream('gzip') → in-process tar parse → drop binaries/lockfiles/build dirs → pack (concat + token estimate) OR search (ranked passages)wrangler secret put GITHUB_TOKEN