Metadata-Version: 2.4
Name: everyonetools-mcp
Version: 0.1.0
Summary: MCP server for the EveryoneTools developer API (/v1): discover and run EveryoneTools tools from MCP clients with your API key.
Author: EveryoneTools
License-Expression: MIT
Project-URL: Homepage, https://everyonetools.com/developers/mcp
Project-URL: Documentation, https://everyonetools.com/developers/docs
Keywords: mcp,model-context-protocol,everyonetools,api,ai-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<3,>=2.3.0
Requires-Dist: httpx<1,>=0.28
Dynamic: license-file

# everyonetools-mcp

MCP server for the [EveryoneTools developer API](https://everyonetools.com/developers). 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

```bash
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.

```bash
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):

```json
{
  "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

| Name | Default | Meaning |
|---|---|---|
| `EVERYONETOOLS_API_KEY` | (required) | Your API key |
| `EVERYONETOOLS_API_BASE` | `https://api.everyonetools.com` | API host |
| `EVERYONETOOLS_MCP_AUTO_IDEMPOTENCY` | `true` | Fold repeat calls with the same input into one charge |
| `EVERYONETOOLS_MCP_LANGUAGE` | `ko` | Language shown first in tool names and descriptions (`ko` or `en`) |

## Links

- Developer portal: <https://everyonetools.com/developers>
- API documentation: <https://everyonetools.com/developers/docs>
- MCP guide: <https://everyonetools.com/developers/mcp>

License: MIT
