{
  "markdown": "<h1 align=\"center\">RunAPI Seedream MCP Server</h1>\n\n<p align=\"center\">\n  <strong>Seedream API access for AI agents: run image generation operations, poll asynchronous results, and check pricing through one focused MCP server.</strong>\n</p>\n\n<p align=\"center\">\n  <sub>Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code, and any MCP-compatible host.</sub>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@runapi.ai/seedream-mcp\"><img src=\"https://img.shields.io/npm/v/%40runapi.ai/seedream-mcp?style=flat-square&color=blue\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/runapi-ai/seedream-mcp\"><img src=\"https://img.shields.io/badge/GitHub-runapi--ai%2Fseedream--mcp-24292f?style=flat-square\" alt=\"GitHub repository\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/License-Apache_2.0-blue?style=flat-square\" alt=\"Apache-2.0 license\"></a>\n  <img src=\"https://img.shields.io/badge/Type-MCP_Server-blue?style=flat-square\" alt=\"MCP Server\">\n  <img src=\"https://img.shields.io/badge/Models-9-16a34a?style=flat-square\" alt=\"9 models\">\n</p>\n\n<p align=\"center\">\n  <a href=\"#install\">Install</a> |\n  <a href=\"#tools\">Tools</a> |\n  <a href=\"#models\">Models</a> |\n  <a href=\"#agent-prompts\">Agent Prompts</a> |\n  <a href=\"#configuration\">Configuration</a> |\n  <a href=\"#links\">Links</a>\n</p>\n\n---\n\n## Why This Package?\n\n`@runapi.ai/seedream-mcp` is a focused Model Context Protocol server for the **Seedream** model line on RunAPI.\nIt gives MCP-compatible assistants direct access to 3 endpoints and 9 model variants without loading the full RunAPI catalog.\n\nUse this per-model server when an agent should stay scoped to Seedream. Use [`@runapi.ai/mcp`](https://github.com/runapi-ai/mcp) when one assistant should discover every RunAPI model line.\n\n---\n\n## Install\n\nAdd it to Claude Code:\n\n```bash\nclaude mcp add seedream -s user -- npx -y @runapi.ai/seedream-mcp\n```\n\nUse project scope when the server should be shared with a repository:\n\n```bash\nclaude mcp add seedream -s project -- npx -y @runapi.ai/seedream-mcp\n```\n\nCodex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:\n\n```json\n{\n  \"mcpServers\": {\n    \"seedream\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@runapi.ai/seedream-mcp\"]\n    }\n  }\n}\n```\n\n`check_pricing` works before sign-in. For task creation and status polling, ask your assistant to call the `login` tool. It opens a browser login and saves credentials to `~/.config/runapi/config.json`, the same file used by `runapi login`.\nHeadless and CI hosts can still set `RUNAPI_API_KEY` before starting the MCP host.\n\nReady-made examples are in [`examples/`](examples/) for Claude, Cursor, Windsurf, VS Code, and Roo Code.\n\n---\n\n## Tools\n\n| Tool | Auth | Purpose |\n|---|---|---|\n| `decompose_layers` | Yes | Create a Seedream decompose layers task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |\n| `edit_image` | Yes | Create a Seedream edit image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |\n| `text_to_image` | Yes | Create a Seedream text to image task and optionally wait for a terminal status. Returns the task id, status, and output URLs. |\n| `get_task` | Yes | Fetch the current status and latest payload for an existing task. |\n| `check_pricing` | No | Look up current pricing for a Seedream model and endpoint. |\n\n---\n\n## Models\n\nSeedream covers 9 model variants across 3 endpoints. Each tool accepts the models listed for it:\n\n| Tool | Models |\n|---|---|\n| `decompose_layers` | `seedream-5-pro-layer-decomposition` |\n| `edit_image` | `seedream-4.5-edit`, `seedream-5-lite-edit`, `seedream-5-pro-edit`, `seedream-v4-edit` |\n| `text_to_image` | `seedream-4.5-text-to-image`, `seedream-5-lite-text-to-image`, `seedream-5-pro-text-to-image`, `seedream-v4-text-to-image` |\n\nModel availability can change between releases. Use `check_pricing` or the [Seedream model page](https://runapi.ai/models/seedream) for the current catalog view.\n\n---\n\n## Agent Prompts\n\nAsk your assistant in natural language; it can inspect pricing, create the task, and return the task id plus output URLs.\n\n### Create a task\n\n```text\nRun a Seedream decompose layers task with RunAPI.\n```\n\nThe assistant can call `check_pricing`, then `decompose_layers`, and return the task id, status, and output URLs.\n\n### Submit without waiting\n\n```text\nCreate the task but don't wait for it to finish.\n```\n\nThe assistant calls the create tool with `wait: false` and returns the task id. Check on it later with `get_task`.\n\n### Check pricing before creating\n\n```text\nCheck current Seedream pricing, then create the task if it matches my request.\n```\n\nThe assistant calls `check_pricing` and can link to the [Seedream model page](https://runapi.ai/models/seedream) for the canonical catalog entry.\n\n---\n\n## Configuration\n\nThe server resolves auth in this order:\n\n1. `RUNAPI_API_KEY` environment variable, useful for headless and CI hosts\n2. `~/.config/runapi/config.json`, created by the MCP `login` tool or `runapi login`\n3. No key, which still allows `check_pricing`\n\nThe config file is normally managed by login. A pre-provisioned headless config can use:\n\n```json\n{\n  \"apiKey\": \"your_runapi_key\"\n}\n```\n\nDo not commit real API keys.\n\n---\n\n## Links\n\n| Resource | URL |\n|---|---|\n| Seedream model page | [https://runapi.ai/models/seedream](https://runapi.ai/models/seedream) |\n| npm package | [@runapi.ai/seedream-mcp](https://www.npmjs.com/package/@runapi.ai/seedream-mcp) |\n| GitHub repository | [runapi-ai/seedream-mcp](https://github.com/runapi-ai/seedream-mcp) |\n| RunAPI MCP overview | [runapi.ai/mcp](https://runapi.ai/mcp) |\n| RunAPI docs | [runapi.ai/docs](https://runapi.ai/docs) |\n\n---\n\n## License\n\nLicensed under the [Apache License, Version 2.0](LICENSE).\n",
  "bytes": 5835,
  "sha": "c33232f02015362d6718c2fdac123a915ef34af22d7cb8dae580d826e68ddd13",
  "repo_slug": "runapi-ai/seedream-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_runapi_builder_seedream_mcp_0da72d83/readme"
}