{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9wgju33qjy5y","handle":"mcp-ntc-road-map-codex-agent","url":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent","links":{"self":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent/record.json","html":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent","markdown":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent/record.md","api":"https://wellknown.network/api/v1/agents/mcp-ntc-road-map-codex-agent","status":"https://wellknown.network/api/v1/agents/mcp-ntc-road-map-codex-agent/status","claim":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent/claim.json","badge":"https://wellknown.network/agents/mcp-ntc-road-map-codex-agent/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-ntc-road-map-codex-agent/history","tools":"https://wellknown.network/api/v1/agents/mcp-ntc-road-map-codex-agent/tools"},"ard":{"identifier":"urn:air::server:mcp-ntc-road-map-codex-agent","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-ntc-road-map-codex-agent","summary":"Portable MCP code-map server for token-efficient coding agents","description":"# ntc-code-map\n\n**Portable MCP code-map server for token-efficient coding agents.**\n\n`ntc-code-map` builds a lightweight index of your repository's files and symbols, then serves a compact, task-aware code map over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Coding agents like [Codex](https://openai.com/codex) use it to understand project structure **before** reading files — saving thousands of tokens per session.\n\n## Why?\n\nLLM coding agents waste tokens on broad `grep`, `find`, and full-file reads to orient themselves. `ntc-code-map` compresses this into a single ranked map call:\n\n| Without ntc-code-map | With ntc-code-map |\n|---|---|\n| Agent reads 10+ files to understand structure | Agent gets a ranked map in ~3500 tokens |\n| Broad `grep -R`, `tree`, `ls -R` | One `repo_map(task)` call |\n| No symbol awareness | Symbol-level navigation + references |\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install mcp-ntc-road-map-codex-agent\n```\n\n### 2. Initialize in your project\n\n```bash\ncd your-project\n\n# Create config\nntc-code-map init\n\n# Build the index\nntc-code-map index\n\n# Check status\nntc-code-map status\n```\n\n### 3. Use with Codex\n\n```bash\n# Auto-configure Codex MCP integration\nntc-code-map init-codex\n\n# Auto-inject workflow into AGENTS.md\nntc-code-map init-agents\n```\n\nThat's it! Codex will now use `ntc-code-map` automatically.\n\n## MCP Tools\n\nWhen running as an MCP server, these tools are available:\n\n| Tool | Description |\n|---|---|\n| `index_status` | Check if the repo index exists and is fresh |\n| `index_repo` | Build/rebuild the SQLite index |\n| `repo_map` | Task-aware ranked map of relevant files + symbols |\n| `find_symbols` | Search symbols by name, kind, scope, signature |\n| `find_files` | Search files by path and content |\n| `module_map` | Compact map for a specific file or directory |\n\n### Recommended agent workflow\n\n```\n1. index_status    → is the index fresh?\n2. index_repo      → rebuild if stale\n3. repo_map(task)  → get ranked contex…","publisher":{"name":"NTC AI","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-ntc-road-map-codex-agent","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["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":"mcp-ntc-road-map-codex-agent","registry":"pypi","observedAt":"2026-11-03T14:24:02.597Z","publishedAt":"2026-07-02T02:43:00.947578Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-ntc-road-map-codex-agent","url":"https://pypi.org/project/mcp-ntc-road-map-codex-agent/","firstSeenAt":"2026-09-10T02:24:15.572Z","fetchedAt":"2026-11-03T14:22:51.617Z","normalizedAt":"2026-11-03T14:22:51.617Z"}]},"firstSeenAt":"2026-09-10T02:24:15.572Z","updatedAt":"2026-11-03T14:24:02.597Z"}