Skip to main content
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.
1

Get your API key

Visit somark.tech/workbench/apikey to get your API key.
2

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"
      }
    }
  }
}
Config file location:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Find the MCP configuration in VS Code settings, or edit .vscode/mcp.json.
Search for MCP in Cursor settings and add the configuration to the corresponding JSON file.
3

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”
4

Check these items first when something fails

ProblemSolution
”API key not configured”Check env.SOMARK_API_KEY in your MCP config
Connection issuesVerify the API key and confirm somark.tech is reachable
File too largeThe current synchronous uploader supports a single file up to 200 MB
Unsupported formatSupports PDF, image, Word, PPT, and Excel files. Confirm the file suffix is in the supported list