Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

com.codmir/mcp

NPM · @CODMIR/MCP · SCANNED AUG 3

AI-powered task execution, tickets, sprints, error debugging, and desktop control.

Available components

+23 this week 63 Trust /100
Trust breakdown (6 categories)

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 Security86
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (94 of 98), 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 (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
  • Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (Apache-2.0).Pass
  • Actively maintained (last published 64 days ago).Pass
  • Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability71
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 2150 tokens (~65/item across 33 items; 33 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

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 · @codmir/mcp

# add to Claude Code
claude mcp add com-codmir-mcp -- npx -y @codmir/mcp
# add to Codex CLI
codex mcp add com-codmir-mcp -- npx -y @codmir/mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-codmir-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codmir/mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add com-codmir-mcp --command npx --arg -y --arg @codmir/mcp
# ~/.hermes/config.yaml
mcp_servers:
  com-codmir-mcp:
    command: "npx"
    args: ["-y", "@codmir/mcp"]
// mcp.json
{
  "mcpServers": {
    "com-codmir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codmir/mcp"
      ]
    }
  }
}
Changelog

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 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 2 Aug 26 +26
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Stability: unverified → 0.23 functional
    • Schema quality: unverified → good functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Licence: Apache-2.0 functional
  • 1 Aug 26 +27
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 −53
    • Known CVEs: partial → unverified security
    • Malware scan: pass → unverified security
    • Tool coverage: 100 → unverified functional
    • Dependency health: partial → unverified functional
    • First check of Schema quality: unverified functional
  • 29 Jul 26 +22
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Licence: Apache-2.0 functional
  • 27 Jul 26 40

    First indexed and scored.

Diagnostics

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/@codmir/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 33 exposed · ~2,150 tokens

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.

Tool Tokens
check_task_status ~34

Check the status of a running task execution.

NameTypeReqDescription
executionIdstringyesThe execution ID returned when task was started

No output schema declared.

No examples provided.

codmir_click ~55

Click at screen coordinates (x, y). Use after taking a screenshot to identify the target location.

NameTypeReqDescription
xnumberyesX coordinate (pixels from left)
ynumberyesY coordinate (pixels from top)

No output schema declared.

No examples provided.

codmir_connect ~98

Establish a real-time agent session with the Codmir desktop app. This announces the AI provider to the desktop UI, which shows a colored border glow indicating which agent is controlling the screen. Call this at the start of any desktop control session.

NameTypeReqDescription
providerstringyesAI provider name: claude, gemini, vercel, cursor, windsurf, or custom name
session_namestringOptional human-readable session label

No output schema declared.

No examples provided.

codmir_disconnect ~26

End the agent session with the Codmir desktop app. Removes the border glow indicator.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

codmir_double_click ~38

Double-click at screen coordinates (x, y).

NameTypeReqDescription
xnumberyesX coordinate
ynumberyesY coordinate

No output schema declared.

No examples provided.

codmir_fetch_page ~83

Fetch a web page through the desktop agent. Returns HTTP status, headers, page title, all links, and the HTML body (truncated at 50KB). Use this for web app testing, crawling routes, and analyzing page content without needing screenshots.

NameTypeReqDescription
urlstringyesFull URL to fetch (e.g. http://localhost:3000/dashboard)

No output schema declared.

No examples provided.

codmir_key ~129

Press a keyboard key or key combination. Use macOS key codes. Common: Return=36, Tab=48, Escape=53, Delete=51, Space=49, Up=126, Down=125, Left=123, Right=124. Flags: Shift=0x20000, Control=0x40000, Option=0x80000, Command=0x100000.

NameTypeReqDescription
flagsnumberModifier flags (e.g. 0x100000 for Command). Default: 0
key_codenumberyesmacOS virtual key code

No output schema declared.

No examples provided.

codmir_list_directory ~94

List files and directories at a path on the desktop machine. Returns file names, sizes, and types. Useful for understanding project structure, finding config files, or mapping a codebase. Skips node_modules, .git, dist, etc.

NameTypeReqDescription
max_depthnumberHow deep to recurse (default: 1, max recommended: 3)
pathstringyesAbsolute directory path to list

No output schema declared.

No examples provided.

codmir_mouse_move ~43

Move the mouse cursor to screen coordinates (x, y) without clicking.

NameTypeReqDescription
xnumberyesX coordinate
ynumberyesY coordinate

No output schema declared.

No examples provided.

codmir_right_click ~43

Right-click at screen coordinates (x, y) to open context menus.

NameTypeReqDescription
xnumberyesX coordinate
ynumberyesY coordinate

No output schema declared.

No examples provided.

codmir_scan_routes ~109

Scan multiple routes on a web app and return status codes for each. Useful for finding 404s, broken pages, redirect chains, and 500 errors. Returns a summary (counts of 200/404/3xx/5xx) and per-route results.

NameTypeReqDescription
base_urlstringyesBase URL (e.g. http://localhost:3000)
routesarrayyesArray of route paths to check (e.g. ["/", "/dashboard", "/settings"])

No output schema declared.

No examples provided.

codmir_screen_info ~31

Get screen dimensions and the name of the frontmost application. Call this first to understand the display layout.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

codmir_screenshot ~36

Capture a screenshot of the entire screen. Returns a base64-encoded PNG image. Use this to see what is currently displayed.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

codmir_scroll ~73

Scroll at the given screen coordinates. Negative delta scrolls down, positive scrolls up.

NameTypeReqDescription
deltanumberScroll amount (negative = down, positive = up). Default: -3
xnumberyesX coordinate to scroll at
ynumberyesY coordinate to scroll at

No output schema declared.

No examples provided.

codmir_shell ~57

Run a shell command on the machine where Codmir desktop is running. Returns stdout, stderr, and exit code.

NameTypeReqDescription
commandstringyesShell command to execute
cwdstringWorking directory (default: home directory)

No output schema declared.

No examples provided.

codmir_status ~31

Check if the Codmir desktop agent is running and connected. Returns status, port, platform, and architecture.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

codmir_type ~40

Type text at the current cursor position. Use codmir_click first to focus the target input field.

NameTypeReqDescription
textstringyesThe text to type

No output schema declared.

No examples provided.

create_organization ~57

Create a new organization/workspace for the user. Required before creating projects.

NameTypeReqDescription
descriptionstringOptional description
namestringyesOrganization name
slugstringURL-friendly identifier (auto-generated if omitted)

No output schema declared.

No examples provided.

create_project ~84

Create a new project within an organization. Required before creating tickets.

NameTypeReqDescription
descriptionstringOptional description
keystringShort project key for ticket prefixes (auto-generated if omitted)
namestringyesProject name
organizationIdstringOrganization ID (uses default org if omitted)
projectTypestringType of project

No output schema declared.

No examples provided.

create_ticket ~77

Create a new ticket in Codmir. Use this to capture bugs, features, or tasks from the conversation.

NameTypeReqDescription
descriptionstringDetailed description
prioritystringTicket priority
projectIdstringyesThe project ID
titlestringyesTicket title
typestringTicket type

No output schema declared.

No examples provided.

execute_task ~77

Execute an AI-powered code task (bug fix, feature implementation, refactor). The task will be queued and executed by a Codmir agent.

NameTypeReqDescription
instructionsstringyesWhat the AI agent should do
projectIdstringyesThe project ID
ticketIdstringOptional ticket ID to link this task to

No output schema declared.

No examples provided.

generate_sdk_code ~69

Generate SDK code for a specific use case. Returns ready-to-use TypeScript code.

NameTypeReqDescription
languagestringTarget language (default: typescript)
useCasestringyesWhat the code should do (e.g., "create a ticket for a bug", "list all projects")

No output schema declared.

No examples provided.

get_error_context ~76

Get enriched error context for AI debugging. Returns the full error report plus suggested files to investigate (extracted from stack frames), a human-readable summary, and similar resolved issues. Ideal for understanding and fixing production errors.

NameTypeReqDescription
referencestringyesAny error reference — refId, digest, reportId, fingerprint, or issueId

No output schema declared.

No examples provided.

get_project_context ~34

Get project overview including tech stack, recent activity, and team info.

NameTypeReqDescription
projectIdstringyesThe project ID

No output schema declared.

No examples provided.

get_sdk_reference ~56

Get Codmir SDK API reference for a specific topic. Use this to learn how to use the SDK for tickets, projects, organizations, chat, or agent tasks.

NameTypeReqDescription
topicstringyesWhich SDK topic to get reference for

No output schema declared.

No examples provided.

get_sprint_tasks ~58

Get tasks for the current or specified sprint. Returns all tasks with their status, assignee, and ticket details.

NameTypeReqDescription
projectIdstringyesThe project ID
statusstringFilter by status (default: all)

No output schema declared.

No examples provided.

get_workspace_status ~27

Check if user has organization and projects set up. Call this first if other tools fail.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_project_tasks ~45

List all tasks for a project.

NameTypeReqDescription
limitnumberMax number of tasks to return (default: 20)
projectIdstringyesThe project ID

No output schema declared.

No examples provided.

list_recent_errors ~86

List recent production errors from the Overseer error store. Returns the most recent errors with their refId, message, severity, route, and timestamp. Useful for getting an overview of current production issues.

NameTypeReqDescription
limitnumberMax number of errors to return (default: 20, max: 50)
severitystringFilter by severity (default: all)

No output schema declared.

No examples provided.

list_todo ~125

Get the to-do list for a project — tickets filtered as actionable items (open/in_progress), sorted by priority. Excludes tickets with auto-execution workflow enabled. Use this for an overview of what needs to be done.

NameTypeReqDescription
assigneeIdstringFilter by assignee user ID
limitnumberMax items to return (default: 50)
prioritystringFilter by priority (default: all)
projectIdstringyesThe project ID
statusstringFilter by status (default: all actionable)

No output schema declared.

No examples provided.

lookup_error ~95

Look up a production error report by any reference: refId (err_xxx), Next.js digest (3681244270), reportId (rpt_xxx), fingerprint (fp_xxx), or issueId (ISS-xxx). Returns the full stored error report with stack trace, breadcrumbs, and metadata.

NameTypeReqDescription
referencestringyesAny error reference — refId, digest, reportId, fingerprint, or issueId

No output schema declared.

No examples provided.

store_conversation ~96

Save this conversation as project documentation. Use to preserve important context, solutions, or decisions.

NameTypeReqDescription
contentstringFull content to save
projectIdstringyesThe project ID
summarystringyesSummary of the conversation
tagsarrayTags for categorization
ticketIdstringOptional ticket to link to
titlestringyesTitle for the saved context

No output schema declared.

No examples provided.

update_todo_status ~68

Update the status of a to-do item (ticket). Use to mark items as done, in progress, or reopen them.

NameTypeReqDescription
projectIdstringyesThe project ID
statusstringyesNew status
ticketIdstringyesThe ticket ID to update

No output schema declared.

No examples provided.