![\"Celina](\"https://raw.githubusercontent.com/andrewkimjoseph/celina/main/assets/celina-banner.svg\")
\n\n \n
\n Celina is a third-party, open-source stack that gives an LLM read, prepare, and execute access to Celo mainnet through an SDK, an MCP server, and a REST API. This package is the Model Context Protocol server — it registers the shared @andrewkimjoseph/celina-sdk/tools catalog — the same Zod schemas and handlers that power browser wallet apps — so MCP and agent hosts stay in sync with the SDK and REST API.\n
\n Website\n ·\n npm\n ·\n Hosted (reads + prepare)\n ·\n Celo docs\n
\n\n## Install\n\n```bash\nnpm i -g @andrewkimjoseph/celina-mcp@latest\n```\n\nFull setup guide (Windows paths, troubleshooting): **[usecelina.xyz/mcp/local](https://www.usecelina.xyz/mcp/local)**.\n\n## Migration\n\nIf you still use `@andrewkimjoseph/celina`, update your MCP config `args` to `@andrewkimjoseph/celina-mcp` and rename the server key to `celina-mcp`. The old package name remains published as a wrapper through one release cycle.\n\n## Quick start\n\n**Recommended:** install globally and connect over stdio — full tool catalog with execute/write when you set `CELO_PRIVATE_KEY`, fast startup, and keys stay on your machine.\n\nYour MCP client (Cursor, Claude Desktop, LM Studio, etc.) runs the **`celina-mcp`** binary over stdio. Tools register from `@andrewkimjoseph/celina-sdk/tools` via `registerSdkTools`. See [Local stdio (recommended)](#local-stdio-recommended) or the [website install guide](https://www.usecelina.xyz/mcp/local).\n\nFor chain reads without a local install, use the hosted Streamable HTTP endpoint at [https://mcp.usecelina.xyz/mcp](https://mcp.usecelina.xyz/mcp) — see [Hosted (reads + prepare)](#hosted-reads--prepare).\n\n## MCP setup\n\nPick your client, install the package, paste the config, restart. Celina shows up as MCP tools your LLM can call.\n\n### Local stdio (recommended)\n\nInstall globally, then add Celina to your MCP config. Your client runs the **`celina-mcp`** binary over stdio. Works in any stdio client (Cursor, Claude Desktop, LM Studio, Continue, MCP Inspector). Use **Node.js 20 or 22 LTS** (≥ 20 supported).\n\n> **Why not `npx -y`?** Cold `npx` starts can exceed Claude Desktop's ~60s MCP handshake on some Windows machines. Global install + an absolute `celina-mcp` path avoids that.\n\nGUI clients (Cursor, Claude Desktop) often spawn MCP servers with a minimal PATH that does not include nvm, fnm, Homebrew, or npm’s global bin. Bare `\"command\": \"celina-mcp\"` then fails with `spawn celina-mcp ENOENT` and the client reconnects in a loop. Paste the absolute path from the commands below into `\"command\"` before you first connect.\n\n1. Run `npm i -g @andrewkimjoseph/celina-mcp@latest`\n2. **Find the binary path** (copy the output into `\"command\"` in step 3):\n - **macOS / Linux:** `which celina-mcp`\n - **Windows (cmd):** `where celina-mcp`\n - **Windows (PowerShell):** `(Get-Command celina-mcp).Source`\n3. Open your MCP config (e.g. `claude_desktop_config.json`, Cursor **Settings → MCP**) and merge a snippet below into `mcpServers`\n4. Fully quit and restart the client\n\n**macOS / Linux example:**\n\n```json\n{\n \"mcpServers\": {\n \"celina-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"/path/to/celina-mcp\",\n \"args\": [],\n \"env\": {\n \"CELO_PRIVATE_KEY\": \"0x...\",\n \"SELF_AGENT_PRIVATE_KEY\": \"0x...\"\n }\n }\n }\n}\n```\n\n**Windows example** (use the `.cmd` shim path from `where` / `Get-Command`; escape backslashes in JSON):\n\n```json\n{\n \"mcpServers\": {\n \"celina-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"C:\\\\Users\\\\YourName\\\\AppData\\\\Roaming\\\\npm\\\\celina-mcp.cmd\",\n \"args\": [],\n \"env\": {\n \"CELO_PRIVATE_KEY\": \"0x...\",\n \"SELF_AGENT_PRIVATE_KEY\": \"0x...\"\n }\n }\n }\n}\n```\n\nReplace `\"command\"` with your `which` / `where` / `Get-Command` output. `\"command\": \"celina-mcp\"` only works if the GUI app inherits npm’s global bin — often false on macOS and Windows. If path lookup is empty, install globally first, or as a last resort use `\"command\": \"node\"` and `\"args\": [\"