everyonetools-mcp

MCP server for the EveryoneTools developer API. It lets MCP clients (Claude Code, Claude Desktop, Cursor and other MCP-compatible tools) discover and run EveryoneTools tools with your API key. Validation, credits and idempotency all happen in the API (/v1); this package is a thin wrapper and contains no calculation logic.

에브리원툴즈 개발자 API의 MCP 서버입니다. MCP 클라이언트(Claude Code, Claude Desktop, Cursor 등)가 내 API 키로 에브리원툴즈 도구를 찾아 실행할 수 있게 합니다. 검증·크레딧·중복 차감 방지는 모두 API(/v1)가 처리합니다.

Requirements

• Python 3.11 or later
• An EveryoneTools API key — sign in at https://everyonetools.com/developers/dashboard and create a key (the free plan includes 500 credits a month)

Run

uvx everyonetools-mcp          # with uv
pipx run everyonetools-mcp     # or with pipx

The server speaks MCP over stdio — your MCP client starts it. Pass the API key only as an environment variable, never as a command argument, and never paste it into a shared project file or a chat.

export EVERYONETOOLS_API_KEY="evt_live_..."          # macOS / Linux
$env:EVERYONETOOLS_API_KEY = "evt_live_..."          # Windows PowerShell

everyonetools-mcp --version prints the installed version.

Connect a client

Claude Code — project file .mcp.json (the key stays in your environment, not in the file):

{
  "mcpServers": {
    "everyonetools": {
      "command": "uvx",
      "args": ["everyonetools-mcp"],
      "env": { "EVERYONETOOLS_API_KEY": "${EVERYONETOOLS_API_KEY}" }
    }
  }
}

Other clients use the same command (uvx everyonetools-mcp) and the same environment variable. If a client can only take the key in its own settings, keep that settings file private and out of version control.

Tools

• The tools the API publishes for MCP — currently calc_loan, calc_vat and text_count (1 credit per successful call). Names are the API tool IDs with . replaced by _.
• get_remaining_credits — plan, balance and limits (not charged).
• download_result_file — download a file produced by a document tool, within its retention (not charged).
• Repeating the same tool with the same input within 24 hours is charged once (EVERYONETOOLS_MCP_AUTO_IDEMPOTENCY, default true).

Environment variables

Links

• Developer portal: https://everyonetools.com/developers
• API documentation: https://everyonetools.com/developers/docs
• MCP guide: https://everyonetools.com/developers/mcp

License: MIT