io.github.x51xxx/codex-mcp-tool
NPM · @TRISHCHUK/CODEX-MCP-TOOL · SCANNED AUG 3
MCP server bridging AI assistants to OpenAI Codex CLI for code analysis and review
Available components
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 →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. 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 20 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability66
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (fair).Partial
- 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 Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @trishchuk/codex-mcp-tool
claude mcp add x51xxx-codex-mcp-tool -- npx -y @trishchuk/codex-mcp-tool
codex mcp add x51xxx-codex-mcp-tool -- npx -y @trishchuk/codex-mcp-tool
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"x51xxx-codex-mcp-tool": {
"type": "local",
"command": [
"npx",
"-y",
"@trishchuk/codex-mcp-tool"
],
"enabled": true
}
}
} openclaw mcp add x51xxx-codex-mcp-tool --command npx --arg -y --arg @trishchuk/codex-mcp-tool
mcp_servers:
x51xxx-codex-mcp-tool:
command: "npx"
args: ["-y", "@trishchuk/codex-mcp-tool"] {
"mcpServers": {
"x51xxx-codex-mcp-tool": {
"command": "npx",
"args": [
"-y",
"@trishchuk/codex-mcp-tool"
]
}
}
} 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.
- 3 Aug 26 +3
- Stability: unverified → 0.23 ▲ functional
- 2 Aug 26 +58
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Security disclosure: fail → unverified ▼ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → fair ▲ functional
- Tool coverage: unverified → 92 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- 1 Aug 26 −19
- Tool coverage: 92 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- 31 Jul 26 −8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 50
First indexed and scored.
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 3 Aug 2026 · Analysed npm/@trishchuk/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
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.
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.