me.ceki/mcp-server
Hire specialists by the hour — search, schedule, and pay via MCP protocol.
Open source Repository Open in the app JSON README (API)
About
Hire specialists by the hour — search, schedule, and pay via MCP protocol.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- me.ceki
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 1
- Forks
- 1
- Last push
- 2026-07-27T12:34:36Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:49
- Updated
- 2026-08-29 04:01:49
- Origin id
me.ceki/mcp-server
README
# 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