{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_g2fb4bgk78vh","handle":"codetex-mcp","url":"https://wellknown.network/agents/codetex-mcp","links":{"self":"https://wellknown.network/agents/codetex-mcp/record.json","html":"https://wellknown.network/agents/codetex-mcp","markdown":"https://wellknown.network/agents/codetex-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codetex-mcp","status":"https://wellknown.network/api/v1/agents/codetex-mcp/status","claim":"https://wellknown.network/agents/codetex-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codetex-mcp/claim.json","badge":"https://wellknown.network/agents/codetex-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codetex-mcp/history","tools":"https://wellknown.network/api/v1/agents/codetex-mcp/tools"},"ard":{"identifier":"urn:air::server:codetex-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codetex-mcp","summary":"Commit-aware code context manager for LLMs - MCP server and CLI","description":"# codetex-mcp\n\nA commit-aware code context manager for LLMs. Indexes Git repositories into a multi-tier knowledge hierarchy — repo overviews, file summaries, and symbol details — stored in SQLite with vector search. Serves context to LLM clients via the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) or a local CLI.\n\n## What It Does\n\ncodetex builds a structured, searchable index of your codebase that LLMs can query on demand:\n\n- **Tier 1 — Repo Overview:** Purpose, architecture, directory structure, key technologies, entry points\n- **Tier 2 — File Summaries:** Per-file purpose, public interfaces, dependencies, roles\n- **Tier 3 — Symbol Details:** Function/class signatures, parameters, return types, call relationships\n\nSummaries are generated by an LLM (Anthropic Claude). Embeddings are computed locally with [sentence-transformers](https://www.sbert.net/) for semantic search. Everything is stored in a single SQLite database with [sqlite-vec](https://github.com/asg017/sqlite-vec) for vector queries.\n\nIncremental sync means only changed files are re-analyzed when you update your code.\n\n## Requirements\n\n- Python 3.12+\n- Git\n- An [Anthropic API key](https://console.anthropic.com/) (for indexing)\n\n## Installation\n\n```bash\n# With pip\npip install codetex-mcp\n\n# With uv (recommended)\nuv tool install codetex-mcp\n```\n\n## Quick Start\n\n### 1. Set your Anthropic API key\n\n```bash\n# Via environment variable\nexport ANTHROPIC_API_KEY=sk-ant-...\n\n# Or via config\ncodetex config set llm.api_key sk-ant-...\n```\n\n### 2. Add a repository\n\n```bash\n# Local repo\ncodetex add /path/to/your/project\n\n# Remote repo (clones to ~/.codetex/repos/)\ncodetex add https://github.com/user/repo.git\n```\n\n### 3. Index it\n\n```bash\n# Preview what indexing will cost (no API calls)\ncodetex index my-project --dry-run\n\n# Build the full index\ncodetex index my-project\n```\n\n### 4. Query your codebase\n\n```bash\n# Repo overview (Tier 1)\ncodetex context my-project\n\n# File summary (Tier 2)\ncodetex context …","publisher":null,"homepage":"https://github.com/mrosata/codetex-mcp","repository":"https://github.com/mrosata/codetex-mcp","version":"0.5.0","license":"MIT","protocols":["mcp"],"tags":["code-context","llm","mcp","sqlite","tree-sitter"],"pricing":null,"endpoints":[{"url":"pypi:codetex-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codetex-mcp","registry":"pypi","observedAt":"2026-11-09T02:25:44.160Z","publishedAt":"2026-03-31T01:36:19.523501Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codetex-mcp","url":"https://pypi.org/project/codetex-mcp/","firstSeenAt":"2026-09-09T12:27:04.338Z","fetchedAt":"2026-11-09T02:24:21.089Z","normalizedAt":"2026-11-09T02:24:21.089Z"}]},"firstSeenAt":"2026-09-09T12:27:04.338Z","updatedAt":"2026-11-09T02:25:44.160Z"}