DMontgomery40/deepseek-mcp-server

An MCP server for DeepSeek V4.1 Flash and V4 Pro APIs: text and visual chat, the
Responses API, FIM completion, Files API lifecycle operations, model discovery,
balance checks, and bounded in-memory conversations.
Version 1.4.0 uses the stable MCP TypeScript SDK v2 and serves both the
2026-07-28 protocol and stateless legacy clients.
What's current
Checked against the official API docs on October 13, 2026:
- The canonical fast model is deepseek-flash, currently DeepSeek V4.1 Flash.
- deepseek-v4-flash and deepseek-v4-flash-vision-exp are temporary aliases
for deepseek-flash.
- deepseek-v4-pro continues serving V4 Pro 0813. DeepSeek reversed its
announced September rerouting plan; Pro remains available with unchanged billing.
- V4.1 Flash accepts visual input through Chat Completions and Responses.
V4 Pro accepts text input. Use list_models to check your account's live availability.
- The Files API supports upload, list, retrieve, and delete for reusable image
inputs.
- DeepSeek documents a 1M-token context window and up to 384K output tokens for
deepseek-flash.
“Multimodal” here means image understanding. This server does not generate
images, video, or audio.
Tools
The server exposes eleven tools:
- chat_completion: text or visual Chat Completions, thinking controls,
function tools, JSON output, streaming aggregation, and optional
conversation_id memory.
- create_response: stateless Responses API calls with text/images, reasoning
controls, function tools, the apply_patch custom tool, structured output, and semantic
streaming aggregation.
- completion: FIM completion through /beta/completions.
- list_models: live model discovery, including display names, context/output
limits, input/output modalities, effort levels, and API capabilities.
- get_user_balance: account availability and balances.
- upload_file: upload base64 JPEG, PNG, GIF, or WebP data and receive a
reusable DeepSeek file_id.
- list_files: list uploaded files with cursor, order, and purpose filters.
- retrieve_file: retrieve metadata for one file_id.
- delete_file: delete one uploaded file.
- reset_conversation: clear one local in-memory conversation.
- list_conversations: list local in-memory conversation IDs.
Every tool declares an MCP output schema and behavior annotations. Full
provider payloads remain opt-in through include_raw_response=true.
API behavior
- Thinking is enabled by default. Canonical reasoning efforts are none,
low, high, and max. Compatibility aliases are accepted: minimal maps
to low; medium and xhigh map to high; the thinking guide also accepts
ultra as an alias for max.
- Chat stream_options requires stream=true. Chat forced tool choices
(required or a named function) require thinking to be disabled.
- Chat prefix completion (prefix=true) and strict function tools
(strict=true) automatically use /beta/chat/completions. Configured /v1
and /beta bases are normalized for beta requests.
- Frequency and presence penalties remain accepted for compatibility, but
DeepSeek ignores them.
- Responses calls are stateless: send full input history. Built-in tools such
as web search are ignored by DeepSeek; accepted legacy web-search shapes
do not enable search. The supported custom tool is
{ "type": "custom", "name": "apply_patch" }. Returned calls appear in
custom_tool_calls; the client is responsible for executing them and
sending custom_tool_call_output history. output_items preserves complete
returned reasoning, message, and tool-call items for replay without enabling
the full raw provider response.
- FIM is beta and non-thinking. It supports streaming usage options;
echo=true cannot accompany suffix or logprobs. Its guide documents a
4K output limit, so do not assume the Chat output ceiling applies.
- DEEPSEEK_REQUEST_TIMEOUT_MS applies to the complete request, including