DeepSeek MCP Server

DeepSeek MCP Server

An MCP server for DeepSeek's current V4.1 Flash API: text and visual chat, the Responses API, FIM completion, Files API lifecycle operations, model discovery, balance checks, and bounded in-memory conversations.

Version 1.0.1 uses the stable MCP TypeScript SDK v2 and serves both the 2026-07-28 protocol and stateless legacy clients.

What's current

As of September 10, 2026:

for deepseek-flash.

• The canonical fast model is deepseek-flash, currently DeepSeek V4.1 Flash.
• deepseek-v4-flash and deepseek-v4-flash-vision-exp are temporary aliases

September 14 until V4.1 Pro is released.

• DeepSeek announced that deepseek-v4-pro will begin serving V4.1 Flash on

inputs.

• V4.1 Flash accepts visual input through Chat Completions and Responses.
• The Files API supports upload, list, retrieve, and delete for reusable image

deepseek-flash.

• DeepSeek documents a 1M-token context window and up to 384K output tokens for

“Multimodal” here means image understanding. This server does not generate images, video, or audio.

Tools

The server exposes eleven tools:

function tools, JSON output, streaming aggregation, and optional conversation_id memory.

• chat_completion: text or visual Chat Completions, thinking controls,

controls, function/custom tools, web search, structured output, and semantic streaming aggregation.

• create_response: stateless Responses API calls with text/images, reasoning

reusable DeepSeek file_id.

• completion: FIM completion through /beta/completions.
• list_models: live model discovery.
• getuserbalance: account availability and balances.
• upload_file: upload base64 JPEG, PNG, GIF, or WebP data and receive a

• list_files: list uploaded files with cursor, order, and purpose filters.
• retrievefile: retrieve metadata for one fileid.
• 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 includerawresponse=true.

Install

Node.js 20 or newer is required.

Run directly over stdio:

DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" npx -y deepseek-mcp-server@1

Codex CLI:

codex mcp add deepseek --env DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" -- npx -y deepseek-mcp-server@1

Claude Code:

claude mcp add deepseek --env DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" -- npx -y deepseek-mcp-server@1

Example MCP client configuration:

Shortened. The full README is on GitHub.