{
  "markdown": "# teneo-book-mcp\n\nMCP server for [Teneo](https://teneo.io). Lets any MCP-capable agent — Claude Desktop,\nCursor, Claude Code, or your own — generate a **complete, publish-ready non-fiction book**:\nfull manuscript, cover, and PDF/EPUB/DOCX files.\n\n```json\n{\n  \"mcpServers\": {\n    \"teneo-book\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"teneo-book-mcp\"],\n      \"env\": { \"TENEO_API_KEY\": \"tk_live_...\" }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `teneo_capabilities` | Discover auth, pricing, request shape, workflow, and output shape. Start here. |\n| `teneo_generate_book` | Start a book (async) → returns a `jobId`. Runs ~45 min. Charged in credits. |\n| `teneo_book_status` | Poll a job; when `completed`, returns download URLs for the cover and PDF/EPUB/DOCX. |\n| `teneo_generate_outline` | Generate an outline only, without running the full pipeline. **Free.** |\n| `teneo_research_niche` | Niche research from a seed topic. **Free.** |\n| `teneo_generate_cover` | Generate a cover only. |\n| `teneo_evaluate_book` | Run quality evaluation on an existing generated book. |\n\n## What it costs\n\nPriced in Teneo credits. One credit is **$69** singly, **$59** each in a 3-pack, **$44.90**\neach in a 10-pack; credits never expire.\n\n```\nrequiredCredits = bookCredits + coverCredits + qualityCreditsReserve\nbookCredits     = wordBandCredits(estimatedWordCount) x modelMultiplier(model_version)\nestimatedWordCount = number_of_chapters x topics_per_chapter x subtopic_count x 350\n```\n\nA default request (12 chapters / 3 topics / 3 subtopics) estimates 37,800 words → **1.05\ncredits, about $72 at list**. `teneo_generate_outline` and `teneo_research_niche` cost\n**nothing**, so validate direction before committing to a paid generation.\n\n**A funded Teneo balance is required before the first paid call** — there is no\npay-per-call endpoint yet. The live numbers, the full model-multiplier table, and the\nrequest schema are always at\n[`/api/agent/capabilities`](https://teneo.io/api/agent/capabilities), which is\nauthoritative if anything here disagrees with it.\n\n## Setup\n\nGet a credential, then add the config block above to your MCP client.\n\n- **Preferred (delegated):** start at [`auth.teneo.io/auth.md`](https://auth.teneo.io/auth.md),\n  register for `https://teneo.io/`, have the user approve the claim, and exchange it for a\n  delegated agent token. Pass it as `TENEO_AGENT_TOKEN`. The delegated user is charged.\n- **Legacy:** create an API key in your Teneo dashboard and pass `TENEO_API_KEY=tk_live_...`.\n- Point at staging with `TENEO_BASE_URL=https://staging.teneo.io`.\n\n## Spend semantics\n\nWorth knowing before you wire this into an autonomous loop:\n\n- **Quoted before charged.** A request that would exceed the balance returns `402` with the\n  full quote and charges nothing — a safe way to read the exact price.\n- **Idempotent.** Send an `Idempotency-Key` header; replaying a request replays the original\n  debit instead of charging twice.\n- **Refunded on failure.** A failed generation is refunded in full.\n- **Async.** A book takes ~45 minutes. Poll `teneo_book_status`, or pass `callback_url` for\n  a completion webhook. Download URLs expire in ~1 hour; re-poll for fresh ones.\n\n## Not for\n\nA single short answer, a blog post, or an article — answer those directly instead. Fiction\nand novels are not supported by this API.\n\n## Develop\n\n```bash\nnpm test          # unit tests for the HTTP client (mocked fetch, no network)\nnpm start         # run the MCP server over stdio\n```\n\n`client.mjs` is a dependency-free HTTP client; `server.mjs` wraps it as MCP tools. Both\nmirror the published\n[OpenAPI contract](https://teneo.io/openapi/agent-book-generation.yaml).\n\n## Links\n\n- Agent front door: <https://teneo.io/agents>\n- Capability manifest: <https://teneo.io/api/agent/capabilities>\n- OpenAPI: <https://teneo.io/openapi/agent-book-generation.yaml>\n- Also installable as an agent skill: `npx skills add https://teneo.io`\n- Official MCP registry: `io.github.Traviseric/teneo-book-mcp`\n\n## License\n\nMIT\n",
  "bytes": 4029,
  "sha": "b1610a2df83fb03063e0d2df984721036cb7e2d4e53f5b23cb989b349d8a534b",
  "repo_slug": "traviseric/teneo-book-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_traviseric_teneo_book_mcp_2448ad1b/readme"
}