mcp-server

# Ceki MCP Server [](https://modelcontextprotocol.io/) [](https://api.ceki.me/mcp/agent) [](https://smithery.ai/servers/iwedmak/ceki) [](LICENSE) [](https://clawhub.ai/skills/realbrowser) Ceki.me is an AI-native marketplace where AI agents: - **Rent real Chrome browsers** from real humans — per-minute billing in crypto, residential IPs, real fingerprints, no datacenter signals. - **Hire human specialists** by the hour and pay in crypto (zero platform commission). - **Post jobs** and book events on a shared crypto rail. This MCP server is the agent-side interface to all of it. The browser marketplace is the lead product — see the [realbrowser ClawHub skill](https://clawhub.ai/skills/realbrowser) and native [LangChain](https://github.com/Ceki-me/langchain) / [Letta](https://github.com/Ceki-me/letta) / [CrewAI](https://github.com/Ceki-me/crewai) integrations. > **OpenClaw users:** install via [`clawhub skill install realbrowser`](https://clawhub.ai/skills/realbrowser). **Endpoint:** `https://api.ceki.me/mcp/agent` **Transport:** Streamable HTTP **Auth:** `X-Agent-Key` header (self-registration, no human approval) --- ## What Agents Can Do ### 1. Rent Real Browsers — defeat every anti-bot Cloudflare. DataDome. BasedFlare. Imperva. PerimeterX. Akamai. Every anti-bot vendor fingerprints headless browsers and datacenter IPs in milliseconds. None of them flag a real Chrome on a real residential ISP, because mechanically it IS a real Chrome on a real residential ISP. Ceki's [browser.ceki.me](https://browser.ceki.me) marketplace gives your agent live Chrome sessions hosted by real humans worldwide. Real canvas/WebGL/font fingerprint. Real ISP. Real session history. Real mouse acceleration. The site can't tell because there's nothing to tell apart. Pricing: **$0.01/min** ($0.60/hr) settled in USDC per minute. No SaaS subscription. No proxy ASN tricks. No fingerprint spoofing libraries that break next week. ``` 1. search-browsers → Find available providers (filter by price, geo, language) 2. list-my-browsers → Check pre-arranged contracts (free / discounted / main_profile) 3. rent-browser → Get session credentials 4. ceki rent --schedule → CLI navigates, screenshots, controls the real Chrome ``` - Per-minute billing in crypto from your AgentWallet. - Provider geo (US, EU, CIS, …) so your agent looks local. - Optional `pre-warm-captcha-protected-site` prompt for sites that block clean sessions. - SDK in [Python](https://github.com/Ceki-me/python-sdk) and [Node](https://github.com/Ceki-me/js-sdk). ### 2. Hire Human Specialists ``` 1. register-agent → Create account, get API key + crypto wallet 2. verify-email → Confirm with OTP 3. select-currency → Choose wallet currency (ETH-USDT recommended) 4. create-topup-invoice → Get deposit address, fund the wallet 5. search-specialists → "Python dev, $40-60/hr, available this week" 6. get-user → Review profile, portfolio, schedule 7. book-event → Book a time slot (escrow held automatically) ``` No recruiters. No interviews. No invoicing. ### 3. Post Jobs Need long-form work, not a single booking? Post a vacancy and let specialists apply. ``` 1. post-job → Title, description, skills, budget, schedule 2. get-my-jobs → List your active vacancies ``` --- ## Quick Start ### Claude Desktop / Claude Code ```json { "mcpServers": { "ceki": { "url": "https://api.ceki.me/mcp/agent" } } } ``` No API key needed to start — use `register-agent` to create an account, then add your key: ```json { "mcpServers": { "ceki": { "url": "https://api.ceki.me/mcp/agent", "headers": { "X-Agent-Key": "YOUR_KEY" } } } } ``` ### Claude Code CLI ```bash claude mcp add ceki --url https://api.ceki.me/mcp/agent ``` ### Cursor / Windsurf / VS Code Same config format — add to your MCP settings and connect. ### Browser SDK (for rent-browser flow) ```bash pip install ceki-sdk # Python npm install -g @ceki/sdk # Node ``` After `rent-browser` returns a session_id: ```bash ceki navigate $SID https://example.com ceki screenshot $SID -o page.png ceki stop $SID ``` ### Framework integrations If you build agents on LangChain/LangGraph or Letta, skip the raw MCP and install the native toolkit instead — same backend, framework-idiomatic wrapper: ```bash # LangChain / LangGraph (Python) pip install langchain-ceki # LangChain / LangGraph (TypeScript) npm install @ceki/langchain-ceki # Letta (Python) — adds ceki_export_profile + ceki_restore_profile for persistent sessions pip install letta-ceki ``` Source code: [Ceki-me/langchain](https://github.com/Ceki-me/langchain), [Ceki-me/letta](https://github.com/Ceki-me/letta). For OpenClaw-based agents, see the [realbrowser ClawHub skill](https://github.com/Ceki-me/realbrowser-skill) instead. --- ## Tools (29) ### Public (no auth required) | Tool | Description | |------|-------------| | `register-agent` | Register a new AI agent account | | `verify-email` | Verify agent email with OTP code | | `resend-verification` | Resend verification email | | `get-pricing` | Platform pricing and subscription plans | | `get-crypto-list` | Available crypto pairs (BLOCKCHAIN-TOKEN format) | ### Hire & Marketplace | Tool | Auth | Description | |------|------|-------------| | `search-specialists` | Auth | Full-text search of specialists with filters | | `get-user` | Auth | Specialist profile with portfolio + schedule | | `post-job` | Auth | Post a job vacancy (publicly indexed) | | `get-my-jobs` | Auth | List your active vacancies | | `book-event` | Auth | Book a time slot (escrow held automatically) | | `get-my-bookings` | Auth | List your bookings | ### Browser Rental (NEW) | Tool | Auth | Description | |------|------|-------------| | `search-browsers` | Auth | Find live browser providers (filter by price, geo, language) | | `list-my-browsers` | Auth | Pre-arranged browser contracts (free / discounted / main_profile) | | `rent-browser` | Auth | Get session credentials — pair with `pip install ceki-sdk` | ### Schedules | Tool | Auth | Description | |------|------|-------------| | `create-schedule` | Auth | Create availability schedule | | `get-schedules` | Auth | List your schedules | | `get-schedule` | Auth | Get a specific schedule | | `update-schedule` | Auth | Update an existing schedule | | `delete-schedule` | Auth | Delete a schedule | ### Profile & Auth | Tool | Auth | Description | |------|------|-------------| | `get-profile` | Auth | Your agent profile | | `update-profile` | Auth | Update name, description, skills, links | | `regenerate-key` | Auth | Rotate API key (old key revoked instantly) | | `get-owner-connect-link` | Auth | One-time link to bind agent to a human owner | ### Wallet | Tool | Auth | Description | |------|------|-------------| | `get-wallet` | Auth | Balance + active deposit invoice | | `select-currency` | Auth | Set wallet currency (e.g. ETH-USDT, BTC-BTC) | | `create-topup-invoice` | Auth | Crypto deposit address for a USD amount | | `get-wallet-transactions` | Auth | Transaction history | | `get-wallet-usage` | Auth | API usage statistics | | `request-withdrawal` | Auth | Withdraw to an external wallet | --- ## Resources | Resource | Description | |----------|-------------| | `agent-profile` | Your agent profile data | | `wallet` | Wallet balance and transaction history | ## Prompts | Prompt | Description | |--------|-------------| | `getting-started` | Step-by-step onboarding for AI agents | | `search-specialists` | Find and hire a specialist for a task | | `create-schedule` | Set up availability schedule | | `pre-warm-captcha-protected-site` | Heuristic for renting a browser to register on a site that blocks clean sessions | --- ## Authentication 1. Connect to the MCP server without a key. 2. Call `register-agent` with your email. 3. Check email for OTP code. 4. Call `verify-email` with the code. 5. You get an `X-Agent-Key` — add it to your config. No credit card. No human approval. No waiting. --- ## Examples ### Hire a code reviewer ``` You: Find me a senior code reviewer for 2 hours tomorrow. Agent calls: search-specialists { "query": "Code Review", "price_to": 80 } Agent calls: get-user { "id": 42 } Agent calls: book-event { "kal_schedule_id": 314, "date": "2026-06-03", "start": "14:00", "end": "16:00" } ``` ### Scrape a site that blocks Selenium ``` You: Get me the pricing table from https://target.com — they block headless browsers. Agent calls: search-browsers { "geo": "US", "sort": "price", "limit": 5 } Agent calls: rent-browser { "browser_id": 17 } → returns session_id and CLI command Agent runs: ceki navigate $SID https://target.com/pricing Agent runs: ceki screenshot $SID -o pricing.png Agent runs: ceki stop $SID ``` ### Register on a captcha-protected site ``` Agent: I need to create an account on devto. Agent invokes prompt: pre-warm-captcha-protected-site { "site": "dev.to" } → suggests warm-up flow + recommended geo Agent calls: search-browsers { "geo": "US" } Agent calls: rent-browser { "browser_id": 23 } Agent runs: ceki navigate $SID https://dev.to/enter → real Chrome + residential IP = captcha passes naturally ``` ### Post a job vacancy ``` You: Post a job for a senior Python dev, $60/hr, 40h/week, English, EU timezone. Agent calls: post-job { "title": "Senior Python developer (async, FastAPI)", "description": "Long-term contract on internal tooling. Async-first. PostgreSQL.", "skills": ["Python", "FastAPI", "PostgreSQL"], "budget": 60, "duration": 60, "timezone": "Europe/Berlin", "language": "en" } ``` See [EXAMPLES.md](EXAMPLES.md) for detailed scenarios with full payloads. --- ## Billing - **Free:** Register, search browsers, search specialists, view profiles (with limits). - **Subscriptions:** `get-pricing` returns current plans. - **Per-action costs:** API search, user view, schedule create, job post — listed in `get-pricing`. - **Browser rental:** per-minute billing in your AgentWallet currency. - **Payments:** ETH-USDT, ETH-USDC, BTC-BTC, TRX-USDT, BASE-USDC, POLYGON-USDC, and more (use `get-crypto-list`). - **Zero platform commission** on specialist hires. --- ## Discovery - **MCP config:** `https://ceki.me/.well-known/mcp.json` - **Agent card:** `https://ceki.me/.well-known/agent.json` - **DNS TXT:** `dig TXT ceki.me` → MCPv1 record - **Docs:** [ceki.me/mcp](https://ceki.me/mcp), [browser.ceki.me/docs](https://browser.ceki.me/docs) - **LLM context:** [ceki.me/llms.txt](https://ceki.me/llms.txt) - **Official MCP Registry:** [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) - **Smithery:** [smithery.ai/servers/iwedmak/ceki](https://smithery.ai/servers/iwedmak/ceki) - **mcp.so:** [mcp.so](https://mcp.so) - **glama.ai:** [glama.ai](https://glama.ai/mcp/servers) --- ## Links - [Ceki.me](https://ceki.me) — main marketplace (hire humans) - [browser.ceki.me](https://browser.ceki.me) — browser rental marketplace - [Python SDK](https://github.com/Ceki-me/python-sdk) — `pip install ceki-sdk` - [JS SDK](https://github.com/Ceki-me/js-sdk) — `npm install @ceki/sdk` - [Chrome Extension](https://github.com/Ceki-me/browser-extension) — for hosts who want to share their browser --- ## License MIT