{
  "markdown": "# project-context\n\n`project-context` is a local, provider-neutral MCP server for repository-scoped\nissue handling. It gives agents one guarded interface to Linear, GitHub Issues,\nGitHub Projects v2, and Jira Cloud while keeping project mappings and\ncredentials outside source repositories.\n\nThe server resolves the current Git repository, selects its configured issue\nprovider, verifies the authenticated account, and separates every write into a\npreview and a single-attempt apply step. Pull requests, releases, repository\nadministration, Git authentication, and commit signing are intentionally out of\nscope.\n\n## Quick start\n\nRequirements: Node.js 22 or newer on Linux or macOS.\n\n```sh\nVERSION=0.1.0\nnpx -y --package=\"@sandovalrr/project-context-mcp@$VERSION\" project-context setup\nnpx -y --package=\"@sandovalrr/project-context-mcp@$VERSION\" project-context doctor\n```\n\nThe first command creates secure, host-local starter files without overwriting\nanything that already exists:\n\n```text\n~/.agents/config/project-context/projects.yaml\n~/.agents/config/project-context/credentials.yaml\n~/.agents/config/project-context/templates/\n~/.agents/config/project-context/secrets/\n~/.local/state/project-context/\n```\n\nCopy and adapt the sanitized examples in `examples/`, validate the result, and\nthen register the `project-context-mcp` stdio command in your MCP client. The\ncomplete Codex, Claude, Zed, and VS Code configurations are in\n[`docs/installation.md`](docs/installation.md).\n\n## Safety model\n\n- Host-local YAML determines the repository, provider, target, and expected\n  identity. Missing or ambiguous context fails closed for writes.\n- Credentials resolve from files, environment variables, OS keychains, or\n  argv-only commands. Literal secrets in YAML are rejected.\n- Provider calls are restricted to fixed HTTPS origins, reject redirects, cap\n  response sizes and timeouts, and never automatically retry writes.\n- Linear issue operations use a fixed allowlist of Linear's hosted MCP tools;\n  project-context never proxies the upstream server's broader tool catalog.\n- Prepared writes expire after ten minutes, are encrypted with AES-256-GCM,\n  and can be claimed only once. An uncertain apply result becomes\n  `indeterminate` and is never replayed automatically.\n- Mutation audit records contain metadata only, are mode `0600`, and rotate\n  locally. The project has no telemetry.\n\nRead [`docs/threat-model.md`](docs/threat-model.md) for trust boundaries and\nresidual risks, and [`docs/routing-and-safety.md`](docs/routing-and-safety.md)\nfor operational behavior.\n\n## Commands and MCP tools\n\n```sh\nproject-context --help\nproject-context setup --guided\nproject-context config validate\nproject-context resolve --cwd /path/to/repository\nproject-context issue list --status open --status in_progress\nproject-context issue list --parent linear:ENG-42\nproject-context issue user search \"John Smith\"\nproject-context issue capabilities\nproject-context issue option search labels security\nproject-context issue option search cycle current\nproject-context issue get linear:ENG-42 --include-relations\nproject-context issue comment list github:#42 --limit 20\nproject-context issue prepare create --title \"Child task\" --parent ENG-42\nproject-context doctor\nproject-context audit list\nproject-context skill status\nproject-context integration manifest --client codex\n```\n\nThe stdio server exposes eleven tools:\n\n- `resolve_project_context`\n- `list_issues`\n- `search_issues`\n- `list_users`\n- `search_users`\n- `search_issue_options`\n- `get_issue_capabilities`\n- `get_issue`\n- `list_issue_comments`\n- `prepare_issue_change`\n- `apply_issue_change`\n\nEvery tool has an input and output schema. Starting the server has no setup side\neffects; when host configuration is absent, tools return an actionable\nstructured error.\n\nLinear additionally supports target-scoped subissues, due dates, estimates,\ncycles, milestones, blocking/related/duplicate relationships, comment replies\nand edits, archived listing, and relation-expanded reads. SLA fields, permanent\ndeletion, and non-issue Linear features are not exposed.\n\nGitHub additionally supports repository issue types and milestones, native\nparent/subissue hierarchies, blocking dependencies, duplicate relationships,\ncomment edits, direct-subissue listing, and relation-expanded reads. GitHub\ncustom-field mappings, generic related-to relationships, threaded comment\nreplies, pull requests, and repository administration are not exposed.\n\n`integration manifest` prints the provider-neutral command definition by\ndefault. Pass `--client codex`, `claude`, `zed`, or `vscode` to emit native,\nready-to-paste configuration pinned to the installed package version. Add\n`--json` when automation needs an envelope containing the client, format, and\nconfiguration.\n\nThe optional `project-issues` agent skill is packaged but never installed as an\nnpm lifecycle side effect:\n\n```sh\nproject-context skill status\nproject-context skill install\n```\n\nUse `--replace` only after reviewing status; replacement creates a timestamped\nbackup.\n\n## Documentation\n\n- [`docs/installation.md`](docs/installation.md): package and MCP client setup.\n- [`docs/configuration.md`](docs/configuration.md): host-local YAML and credential resolvers.\n- [`docs/architecture.md`](docs/architecture.md): components and runtime boundaries.\n- [`docs/provider-behavior.md`](docs/provider-behavior.md): provider-specific behavior.\n- [`docs/releasing.md`](docs/releasing.md): bootstrap, semantic release, npm, and MCP Registry.\n- [`CONTRIBUTING.md`](CONTRIBUTING.md): development and review requirements.\n- [`SECURITY.md`](SECURITY.md): supported versions and private reporting.\n\n## License and attribution\n\nThis project is available under the [MIT License](LICENSE), copyright 2026\nRichard Sandoval. The copyright and permission notice must remain with copies\nor substantial portions of the software.\n\nIf this repository is used as the starting point for another project, a visible\nacknowledgment is appreciated:\n\n> Based on project-context, created by Richard Sandoval.\n",
  "bytes": 6062,
  "sha": "27b70ac2bd3431cf5ff951ce9bdfce5b07b966cec311760212b4a3226e37324d",
  "repo_slug": "sandovalrr/project-context",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sandovalrr_project_context_518a9330/readme"
}