What the SameDayDesk agent tools MCP server does
SameDayDesk agent tools MCP server packages public discovery and offline result handling around SameDayDesk. Its documented entry points cover presence checks, result-reuse previews and exports, and routing a known job to an existing SameDayDesk or Neomorphic offer. The repository also describes readiness checks, TaskMarket reads, a paid Fix Pack, and caller-declared funnel evidence, although the excerpt provides fewer operational details for those areas than for the public helper scripts.
The repository is designed for agents that need to distinguish free discovery from paid routes and live observations from fixture data. It can inspect public catalogs at agents.samedaydesk.com, fall back when the apex site cannot establish TLS or a connection, and produce local task-memory observations from supplied JSON.
How it works
SameDayDesk agent tools MCP server supports two cold-read paths. With preferFixture: true, the presence helper performs no network access and returns an offline_fixture outcome. Without that option, it uses free HTTP discovery; when the apex endpoint fails but the alternate agents endpoints respond, the result can be alternate_live. These paths do not require payment.
Result reuse operates on repository fixtures. The preview command shows the proposed observation without writing it, while export writes a JSON observation only when the caller supplies --opt-in, a task ID, subject, sequence, clock, and output path. The documented observation schema is neomorphic.task-memory.observation.v1.
Offer routing reads a job fixture and consults the capability and limits matrix before selecting an existing offer. It does not evaluate acceptance criteria, authorize payment, or imply that an unavailable acquisition route exists.
Setup and configuration
Use Node 22.x and run commands from a clean repository checkout. The documented examples use native ESM files under tools/; no package installation is required. The repository includes focused test commands for public entry behavior, presence checks, result reuse, and offer routing.
Live discovery is optional. Offline checks and fixture-based result reuse use no network. Exporting an observation requires explicit opt-in, which helps prevent an incidental preview from creating a file.
Tools and capabilities
- Perform an offline or live cold-read presence check.
- Read the alternate free catalogs at
agents.samedaydesk.com when the apex endpoint is unavailable.
- Preview or export task-memory observations from accepted page-change and record-report fixtures.
- Route a known job through the offer capability and limits matrix.
- Keep payment out of the documented free discovery and fixture workflows.
Limitations and notes
The SameDayDesk agent tools MCP server does not make paid extract or batch routes part of the free helper flow. The routing example explicitly reports that complete issue-discussion acquisition is unavailable and does not select an offer. The matrix also does not advertise the pending issue-evidence acquisition pack.
The MoltJobs SDK pack is described as a disposable local HTTP rehearsal; its shipped runner refuses --live even when credentials are present. Hosted archives are downloads rather than hosted job execution. Apex connectivity may fail, and alternate live results should not be confused with offline fixtures. The excerpt does not document a client-specific MCP transport, environment-variable configuration, or a package-install workflow.