io.github.x51xxx/codex-mcp-tool
NPM · @TRISHCHUK/CODEX-MCP-TOOL
MCP server bridging AI assistants to OpenAI Codex CLI for code analysis and review
Available components
Last scanned (57 minutes ago)
Scores higher than 58% of npm servers
Category Developer Tools
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security81
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 30 of 93 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 35 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2333 tokens (~179/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage95
- 92% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
- 99% of tool parameters carry a description.Partial
- Structured output schemas are declared (46% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Nov 26 0
- Stability: 0.97 → pass security
- 1 Nov 26 0
- Stability: pass → 0.97 functional
- 26 Oct 26 0
- Stability: 0.97 → pass security
- 25 Oct 26 0
- Stability: pass → 0.97 functional
- 24 Oct 26 −5
- CVE-2023-54404 affects this package: high ▼ security
- Known CVEs: pass → fail ▼ security
- 17 Oct 26 +1
- Stability: 0.90 → pass security
- 15 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Oct 26 −2
- Stability: pass → 0.83 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed npm/@trishchuk/codex-mcp-tool@2.2.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-mrhx-c7xc-m3w5 | CVE-2023-54404 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 93 packages
| Packages resolved | 93 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ask-codex ~860
Execute Codex CLI with file analysis (@syntax), skills ($syntax), model selection, and safety controls. Supports changeMode.
| Name | Type | Req | Description |
|---|---|---|---|
| addDirs | array | – | Additional writable directories beyond workspace (e.g., ["/tmp", "/var/log"]). Useful for monorepos and multi-directory projects. |
| approval | string | – | Approval policy: untrusted, on-failure, on-request, never |
| approvalPolicy | string | – | Approval: never, on-request, on-failure, untrusted |
| cd | string | – | Working directory |
| changeMode | boolean | – | Return structured OLD/NEW edits for refactoring |
| chunkCacheKey | string | – | Cache key for continuation |
| chunkIndex | number | – | Chunk index (1-based) |
| config | – | – | Configuration overrides as 'key=value' string or object |
| disableFeatures | array | – | Disable feature flags (repeatable). Equivalent to -c features.<name>=false |
| enableFeatures | array | – | Enable feature flags (repeatable). Equivalent to -c features.<name>=true |
| fullAuto | boolean | – | Full automation mode |
| image | – | – | Optional image file path(s) to include with the prompt |
| includeMetadata | boolean | – | Include configuration metadata in response |
| includeThinking | boolean | – | Include reasoning/thinking section in response |
| localProvider | string | – | Specify which local provider to use (lmstudio or ollama). Automatically enables --oss if not set. If omitted with --oss, uses config default or shows selection. |
| model | string | – | Model: gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini, gpt-5.2. Default: gpt-5.4 |
| oss | boolean | – | Use local Ollama server (convenience for -c model_provider=oss). Requires Ollama running locally. Automatically sets sandbox to workspace-write if not specified. |
| outputLastMessage | string | – | Write final Codex message to file path. Useful for CI/CD result capture (Codex CLI v0.95.0+) |
| outputSchema | – | – | JSON Schema path or inline schema to constrain output format (Codex CLI v0.95.0+) |
| personality | string | – | Communication style: pragmatic (concise, machine-friendly) or friendly (conversational). Codex CLI v0.94.0+ |
| profile | string | – | Configuration profile to use from ~/.codex/config.toml |
| prompt | string | yes | Task or question. Use @ to include files (e.g., '@largefile.ts explain'). |
| reasoningEffort | string | – | Reasoning depth level: low (fast), medium (default), high (complex), xhigh (extra deep) |
| resetSession | boolean | – | Clear session context before execution. Starts fresh conversation. |
| responseMode | string | – | Response verbosity: "clean" returns only the final answer (default), "full" returns the complete execution log including thinking, tool calls, and agent activity |
| sandbox | boolean | – | Quick automation mode: enables workspace-write + on-failure approval. Alias for fullAuto. |
| sandboxMode | string | – | Access: read-only, workspace-write, danger-full-access |
| search | boolean | – | Enable web search using native --search flag (v0.52.0+). Requires network access - automatically sets sandbox to workspace-write if not specified. |
| sessionId | string | – | Session ID for conversation continuity. Enables native Codex resume. |
| skipGitRepoCheck | boolean | – | Skip git repository validation. Useful for non-git directories (Codex CLI v0.75.0+) |
| timeout | number | – | Maximum execution time in milliseconds (optional) |
| toolOutputTokenLimit | number | – | Maximum tokens for tool outputs (100-10,000). Controls response verbosity. |
| workingDir | string | – | Working directory for execution |
| yolo | boolean | – | ⚠️ Bypass all safety (dangerous) |
No output schema declared.
No examples provided.
batch-codex ~244
Delegate multiple atomic tasks to Codex for batch processing. Ideal for repetitive operations, mass refactoring, and automated code transformations
| Name | Type | Req | Description |
|---|---|---|---|
| disableFeatures | array | – | Disable feature flags |
| enableFeatures | array | – | Enable feature flags |
| model | string | – | Model to use: gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini, gpt-5.2 |
| oss | boolean | – | Use local Ollama server |
| parallel | boolean | – | Execute tasks in parallel (experimental) |
| sandbox | string | – | Sandbox mode: read-only, workspace-write, danger-full-access |
| search | boolean | – | Enable web search for all tasks (activates web_search_request feature) |
| stopOnError | boolean | – | Stop execution if any task fails |
| tasks | array | yes | Array of atomic tasks to delegate to Codex |
| timeout | number | – | Maximum execution time per task in milliseconds |
| workingDir | string | – | Working directory for execution |
| Name | Type | Req | Description |
|---|---|---|---|
| failed | number | yes | – |
| results | array | yes | – |
| skipped | number | yes | – |
| successful | number | yes | – |
| total | number | yes | – |
No examples provided.
brainstorm ~444
Generate creative ideas using structured frameworks with domain context and feasibility analysis.
| Name | Type | Req | Description |
|---|---|---|---|
| approvalPolicy | string | – | Approval: never, on-request, on-failure, untrusted |
| cd | string | – | Working directory |
| constraints | string | – | Limitations: budget, time, technical, legal, etc. |
| disableFeatures | array | – | Disable feature flags |
| domain | string | – | Domain: software, business, creative, research, product, marketing, etc. |
| enableFeatures | array | – | Enable feature flags |
| existingContext | string | – | Background info or previous attempts |
| fullAuto | boolean | – | Full automation mode |
| ideaCount | integer | – | Number of ideas (default: 12, range: 5-30) |
| includeAnalysis | boolean | – | Include feasibility/impact analysis |
| localProvider | string | – | Specify which local provider to use (lmstudio or ollama). Automatically enables --oss if not set. |
| methodology | string | – | Framework: divergent, convergent, scamper, design-thinking, lateral, auto (default) |
| model | string | – | Model: gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini, gpt-5.2. Default: gpt-5.4 |
| oss | boolean | – | Use local Ollama server |
| personality | string | – | Communication style: pragmatic (concise, machine-friendly) or friendly (conversational). Codex CLI v0.94.0+ |
| prompt | string | yes | Brainstorming challenge or question |
| reasoningEffort | string | – | Reasoning depth: low (fast), medium (default), high (complex), xhigh (extra deep) |
| sandboxMode | string | – | Access: read-only, workspace-write, danger-full-access |
| search | boolean | – | Enable web search for research (activates web_search_request feature) |
| yolo | boolean | – | ⚠️ Bypass all safety (dangerous) |
No output schema declared.
No examples provided.
do-act ~253
Execute task via Codex, verify with shell command, auto-fix on failure. Act-Check-Fix loop.
| Name | Type | Req | Description |
|---|---|---|---|
| fullAuto | boolean | – | Full automation mode |
| localProvider | string | – | – |
| maxRetries | integer | – | Max retry attempts if verify fails. Default: 2 |
| model | string | – | Model: gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini, gpt-5.2. Default: gpt-5.4 |
| oss | boolean | – | Use local Ollama/LM Studio |
| reasoningEffort | string | – | Reasoning depth |
| sandboxMode | string | – | Access: read-only, workspace-write, danger-full-access |
| task | string | yes | Task for Codex to execute |
| timeout | number | – | Codex timeout per attempt in ms. Default: 10min |
| verify | object | – | Shell command to validate result. Triggers act-check-fix loop on failure. |
| workingDir | string | – | Working directory |
| Name | Type | Req | Description |
|---|---|---|---|
| attempts | number | yes | – |
| durationMs | number | yes | – |
| status | string | yes | – |
| steps | array | yes | – |
No examples provided.
fetch-chunk ~66
Retrieves cached chunks from a changeMode response. Use this to get subsequent chunks after receiving a partial changeMode response.
| Name | Type | Req | Description |
|---|---|---|---|
| cacheKey | string | yes | The cache key provided in the initial changeMode response |
| chunkIndex | number | yes | Which chunk to retrieve (1-based index) |
No output schema declared.
No examples provided.
health ~43
Check Codex CLI and session health status
| Name | Type | Req | Description |
|---|---|---|---|
| sessionId | string | – | Optional session ID to check specific session health |
| verbose | boolean | – | Include detailed diagnostic information |
| Name | Type | Req | Description |
|---|---|---|---|
| codexCli | object | yes | – |
| features | object | yes | – |
| issues | array | yes | – |
| sessions | object | yes | – |
| status | string | yes | – |
No examples provided.
Help ~11
receive help information
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list-sessions ~56
List all active conversation sessions with metadata, or manage sessions
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | – | Action: list (default), delete (single session), clear (all sessions) |
| sessionId | string | – | Session ID for delete action |
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | – |
| sessions | array | – | – |
| stats | object | – | – |
No examples provided.
list-skills ~42
Discover available Codex skills from .agents/skills/ directory
| Name | Type | Req | Description |
|---|---|---|---|
| workingDir | string | – | Working directory to search for skills. Defaults to resolved working directory. |
| Name | Type | Req | Description |
|---|---|---|---|
| baseDir | string | yes | – |
| skills | array | yes | – |
No examples provided.
ping ~19
Echo
| Name | Type | Req | Description |
|---|---|---|---|
| prompt | string | – | Message to echo |
No output schema declared.
No examples provided.
review-changes ~249
Run a code review against the current repository using Codex CLI native review subcommand
| Name | Type | Req | Description |
|---|---|---|---|
| base | string | – | Review changes against a specific base branch (e.g., "main", "develop") |
| commit | string | – | Review the changes introduced by a specific commit SHA |
| model | string | – | Model: gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini, gpt-5.2. Default: uses Codex's default |
| prompt | string | – | Custom review instructions or focus areas (cannot be used with uncommitted=true; use base/commit review instead) |
| timeout | number | – | Maximum execution time in milliseconds |
| title | string | – | Optional title to display in the review summary |
| uncommitted | boolean | – | Review staged, unstaged, and untracked changes (working tree) - cannot be combined with custom prompt |
| workingDir | string | – | Working directory to run the review in (passed via -C as a global Codex option) |
No output schema declared.
No examples provided.
timeout-test ~33
Test timeout prevention by running for a specified duration
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | yes | Duration in milliseconds (minimum 10ms) |
No output schema declared.
No examples provided.
version ~13
Display version and system information
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| codexCli | string | – | – |
| mcpServer | string | yes | – |
| nodeJs | string | yes | – |
| platform | string | yes | – |
No examples provided.
How do I install the io.github.x51xxx/codex-mcp-tool server?
io.github.x51xxx/codex-mcp-tool runs locally as an npm package, launched with npx -y @trishchuk/codex-mcp-tool. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @trishchuk/codex-mcp-tool
claude mcp add x51xxx-codex-mcp-tool -- npx -y @trishchuk/codex-mcp-tool
What is the io.github.x51xxx/codex-mcp-tool server?
io.github.x51xxx/codex-mcp-tool is listed in the public MCP registry as io.github.x51xxx/codex-mcp-tool. MCP server bridging AI assistants to OpenAI Codex CLI for code analysis and review. This page covers its npm package (@trishchuk/codex-mcp-tool).
Is the io.github.x51xxx/codex-mcp-tool server safe to use?
io.github.x51xxx/codex-mcp-tool scores 78 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.x51xxx/codex-mcp-tool server expose?
io.github.x51xxx/codex-mcp-tool exposes 13 tools: ask-codex, batch-codex, review-changes, ping, Help, and 8 more. Their descriptions and schemas cost roughly 2,333 tokens of context every time the server is loaded.
Is the io.github.x51xxx/codex-mcp-tool server still maintained?
io.github.x51xxx/codex-mcp-tool is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.x51xxx/codex-mcp-tool server under?
io.github.x51xxx/codex-mcp-tool declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.