{
  "markdown": "<!-- mcp-name: io.github.Toloka/tendem-mcp -->\n# Tendem MCP\n\n**Delegate tasks to vetted human experts — straight from your AI assistant.** 🧑‍🔬🤝🤖\n\n[Tendem](https://tendem.ai) gives your AI direct access to vetted human experts\nfor the work an agent alone can't nail: judgment-heavy research, competitive\nanalysis, copywriting and editing, design review, data cleaning, and complex\nmulti-step tasks. You (or your agent) submit a task in plain English — Tendem\n**scopes the work, quotes a transparent price, and delivers verified results**\nback into the chat as files, reports, or structured outputs. Agent *plus* expert\nraises the quality ceiling of what you can ship well beyond what either does\nalone.\n\nIdeal for founders, creators, operators, and consultants who need reliable\nexpert output without managing freelancers.\n\n**Get started → [agent.tendem.ai](https://agent.tendem.ai).**\n\nThis repo is the **official distribution home** for the Tendem MCP plugin — the\npart that lives in your AI client. Install it and your assistant arrives already\nknowing how to drive the full Tendem lifecycle: create → scope → approve →\nfetch, with clean polling and spend safety built in.\n\n> The MCP server itself is **hosted** at `https://mcp.tendem.ai/mcp` — it is not\n> in this repo. This repo contains the client-side plugins, skills, and rules\n> that teach your AI client to use the hosted server well.\n\n## Start using Tendem\n\n### 1. The web interface\n\nSign in at **[agent.tendem.ai](https://agent.tendem.ai)** to create your\naccount, top up your balance, and watch tasks run end-to-end. The full output of\nevery task — markdown plus downloadable files — is always available there, no\nmatter which client you launched it from.\n\n### 2. Install the plugin in your AI client\n\nThe hosted server URL is the same everywhere: `https://mcp.tendem.ai/mcp`\n(streamable HTTP, OAuth on first use). Pick your client:\n\n#### Claude Code\n\n```\n/plugin marketplace add Toloka/tendem-mcp\n/plugin install tendem@tendem-mcp\n```\n\n#### OpenAI Codex / ChatGPT\n\n```\ncodex plugin marketplace add Toloka/tendem-mcp\ncodex plugin add tendem@tendem-mcp\n```\n\nComplete the MCP server's OAuth login on first tool use.\n\n#### GitHub Copilot CLI\n\n```\ncopilot plugin marketplace add Toloka/tendem-mcp\ncopilot plugin install tendem@tendem-mcp\n```\n\n#### Gemini CLI\n\n```\ngemini extensions install https://github.com/Toloka/tendem-mcp\n```\n\nThen authenticate inside Gemini with `/mcp auth tendem`. The catalog entry is\n[`gemini-extension.json`](./gemini-extension.json) at the repo root.\n\n#### Kiro\n\nKiro Powers register through the IDE. Point Kiro at the\n[`tendem-power/`](./tendem-power/) steering bundle in this repo, then connect the\n`tendem` MCP server when prompted.\n\n#### Manual (any MCP-compatible client)\n\nAdd to your client's MCP config and sign in when prompted:\n\n```json\n{\n  \"mcpServers\": {\n    \"tendem\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.tendem.ai/mcp\"\n    }\n  }\n}\n```\n\n## Build agentic pipelines (API-key auth)\n\nFor headless, CI, or programmatic use — where the interactive OAuth flow isn't\nviable — authenticate with a Tendem **API key** instead: sign in at\n[agent.tendem.ai/mcp](https://agent.tendem.ai/mcp) and create one under the\n**Agent builders** tab.\n\n**Python / LangChain / LangGraph:** skip the raw MCP wiring and use\n[`langchain-tendem`](./integrations/langchain-tendem/) — four price-capped\ntools that let an agent create a task, answer the service's questions, and\ncollect the verified result, with all polling in plain Python (no LLM, no\ntokens).\n\nFor every other stack, a native `\"type\": \"http\"` remote server triggers the\ninteractive OAuth flow, so\nto pass a static API key instead, bridge the connection through\n[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) — a local stdio process\nthat connects to the hosted URL and injects your `Authorization: ApiKey` header:\n\n```json\n{\n  \"mcpServers\": {\n    \"tendem\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://mcp.tendem.ai/mcp\",\n        \"--transport\",\n        \"http-only\",\n        \"--header\",\n        \"Authorization: ApiKey <your-tendem-api-key>\"\n      ]\n    }\n  }\n}\n```\n\nKeep the token out of source control (inject it from an environment variable or\nsecret store). Your custom agent loop drives the same eleven tools the plugin\nuses — `create_task`, `get_task`, `get_contract`, `get_task_result`,\n`list_tasks`, `approve_task`, `cancel_task`, `send_message`, `read_chat`,\n`get_account`, `get_file_upload_url` — to implement the create → scope →\napprove → poll → fetch lifecycle yourself. The server ships a\n`tendem-quickstart` prompt with a full walkthrough.\n\n> **Spend safety:** `approve_task` is what triggers a charge. In an automated\n> pipeline, gate it behind your own approval logic and check `get_account`\n> first — an insufficient balance returns a task-bound top-up URL, not an error\n> to retry.\n\n## What's in this repo\n\n| Path | What it is |\n|---|---|\n| [`plugins/tendem/`](./plugins/tendem/) | The plugin for **Claude Code, Cursor, and GitHub Copilot CLI** — skill, slash commands, background watcher agent, notification hook, and the MCP connector |\n| [`codex/tendem/`](./codex/tendem/) | The plugin for **OpenAI Codex / ChatGPT** — explicit `$`-skills and Codex-specific file-upload guidance |\n| [`tendem-power/`](./tendem-power/) | The **Kiro** Power (steering + MCP config) |\n| [`gemini-extension.json`](./gemini-extension.json) | The **Gemini CLI** extension manifest (root install) |\n| [`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json) | This repo's **Claude Code** marketplace |\n| [`.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json) | This repo's **Codex** marketplace |\n| [`server.json`](./server.json) | MCP Registry manifest (remote server) |\n| [`llms.txt`](./llms.txt) | LLM discovery index |\n\n### What the plugin teaches your assistant\n\nInstalling does more than wire up the connector — it ships steering so your AI\nhandles Tendem correctly out of the box:\n\n- **`tendem-tasks` skill** — the end-to-end path (create → scope → approve →\n  fetch), silent long-polling without busy-loops, scope negotiation, and\n  live-verified file upload/download mechanics. Loads only when work actually\n  involves Tendem.\n- **`/tendem-task`, `/tendem-status`, `/tendem-result`** — explicit entry points\n  to submit, check, and fetch a task (in Codex these are `$tendem-task` etc.).\n- **`tendem-watcher` agent** (Claude / Copilot) — a background watcher that polls\n  a running task at a slow pace and pings you the moment it needs you.\n- **Notification hook** — a desktop notification when a task transitions to\n  needing you (quote ready, top-up needed, input needed, result ready).\n\n## For contributors\n\n- [AGENTS.md](./AGENTS.md) — guide for AI agents working in this repo\n- [CONTRIBUTING.md](./CONTRIBUTING.md) — how to contribute\n- **Per-client manifests**: [Claude Code](./plugins/tendem/.claude-plugin/plugin.json),\n  [OpenAI Codex](./codex/tendem/.codex-plugin/plugin.json),\n  [Cursor](./plugins/tendem/.cursor-plugin/plugin.json),\n  [GitHub Copilot CLI](./plugins/tendem/.github/plugin/plugin.json), and\n  [Gemini CLI](./gemini-extension.json)\n\n## Links\n\n- **Product:** [tendem.ai](https://tendem.ai) · **App:** [agent.tendem.ai](https://agent.tendem.ai)\n- **Overview:** [Connect your AI agent to human experts via MCP](https://toloka.ai/blog/connect-your-ai-agent-to-human-experts-via-mcp/)\n- **Legal:** [Privacy Policy](https://tendem.ai/legal/privacy) · [Terms of Use](https://tendem.ai/legal/terms)\n- **Support:** [Help center](https://tolokahelp.zendesk.com/hc/en-us)\n\n---\n\n*Tendem MCP is part of the [Model Context Protocol](https://modelcontextprotocol.io/) ecosystem.*\n",
  "bytes": 7737,
  "sha": "b834d7833a25bfb77563dafed165b0ccd3da63ca1cca36c3a0435464c13ddb7b",
  "repo_slug": "toloka/tendem-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_toloka_tendem_mcp_2331f8b7/readme"
}