SoMark MCP

SoMark MCP Server is the right fit for Claude Desktop, VS Code, Cursor, and other MCP-capable clients that should call SoMark directly through the assistant. If you are still comparing integration paths, start with the get started overview; if your environment is Skill-based instead, switch to SoMark Skill.

Get your API key

Visit somark.ai/Studio/apikey to get your API key.

Configure your MCP client

Add the following to your MCP client’s configuration file:

{
  "mcpServers": {
    "somark": {
      "command": "npx",
      "args": ["-y", "somark-mcp"],
      "env": {
        "SOMARK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

VS Code

Find the MCP configuration in VS Code settings, or edit .vscode/mcp.json.

Cursor

Search for MCP in Cursor settings and add the configuration to the corresponding JSON file.

Start parsing

Once configured, ask your AI assistant directly:

“Parse this PDF for me” “Extract the key clauses from this contract” “Convert this image to Markdown”

Check these items first when something fails

Problem	Solution
”API key not configured”	Check `env.SOMARK_API_KEY` in your MCP config
Connection issues	Verify the API key and confirm somark.ai is reachable
File too large	The current synchronous uploader supports a single file up to 200 MB
Unsupported format	Supports PDF, image, Word, PPT, and Excel files. Confirm the file suffix is in the supported list

SoMark Skill Using SoMark in Feishu

Overview

Quickstart

Ecosystem

FAQs