A production-grade DeepSeek V4 MCP server for Codex agents with browser UI, request/response archival, and token cost estimation.
Strong tool definitions with comprehensive schemas and descriptions. All 15 tools have clear names following verb_noun pattern (request_*, response_*, reasoning_*, account_*, server_*). Descriptions are detailed (100-300 chars typical), exceeding the 10-1024 baseline. Input schemas are fully specified with Zod validation, enums for constrained inputs, and parameter descriptions. However, output schemas are not documented in the source code, LLMs cannot see what fields to expect from responses. Error handling is present but recovery guidance is minimal. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications in metadata.
Get the current DeepSeek account balance and available funds.
Read the reasoning content for a specific request version.
Append text content to the current active request version.
Append a single text file or ZIP archive of text files to the current active request version.
Deprecated: ZIP-only compatibility tool. Prefer request_append_file. Append a ZIP archive of text files to the current active request version.
Archive an active request and all its versions to the archive directory.
Output schemas not documented. LLMs cannot see what fields response_read, reasoning_read, request_list, and request_versions return. This forces agents to guess field names and risks failed downstream tool calls.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tools are marked with Risk metadata (READ_ONLY, WRITE, REVERSIBLE) in comments but not exposed via MCP protocol. Agents cannot distinguish safe reads from destructive writes without parsing descriptions.
Error recovery guidance is minimal. Tools reference RequestStoreError and DeepSeekAccountBalanceError but source does not show error messages that tell LLMs what to do next (e.g., 'Request not found. Try request_list() to find valid IDs.').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2025-06-18+ | v2 |
Submit multiple requests in parallel to DeepSeek API.
Create a new DeepSeek request with optional initial text content.
List active or archived DeepSeek requests with optional filtering by status, creation time, and pagination.
Read the current active version of a request by id.
Submit the current active request version to DeepSeek API and save the response and reasoning.
Replace the entire content of the current active request version.
List all versions of a request with their status and metadata.
Read the response for a specific request version.
Get server capabilities, configuration, and request model layout.
request_append_zip marked deprecated but still exposed. Deprecation note in description is good, but no guidance on migration path or timeline. LLMs may still select it over request_append_file.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Dockerfile shows HTTP support (DEEPSEEK_MCP_HTTP_ENABLED=true, port 8799) but transport detection shows STDIO. Verify HTTP is properly exposed in MCP protocol negotiation.