English Français العربية

Teneo Book Generation

السجل الرسمي الإنتاجية

Publish-ready nonfiction books from a topic: manuscript, cover, PDF/EPUB/DOCX. Free outline to try.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package teneo-book-mcp
Claude Code 
claude mcp add teneo-book-generation -e 'TENEO_API_KEY=<your teneo_api_key>' -e 'TENEO_BASE_URL=<TENEO_BASE_URL>' -e 'TENEO_SERVICE_KEY=<your teneo_service_key>' -e 'TENEO_ON_BEHALF_OF=<TENEO_ON_BEHALF_OF>' -- npx -y teneo-book-mcp@1.0.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "teneo-book-generation": {
            "command": "npx",
            "args": [
                "-y",
                "teneo-book-mcp@1.0.3"
            ],
            "env": {
                "TENEO_API_KEY": "<your teneo_api_key>",
                "TENEO_BASE_URL": "<TENEO_BASE_URL>",
                "TENEO_SERVICE_KEY": "<your teneo_service_key>",
                "TENEO_ON_BEHALF_OF": "<TENEO_ON_BEHALF_OF>"
            }
        }
    }
}

متغيرات البيئة

  • TENEO_API_KEY إلزامي سري Per-agent API key from the Teneo dashboard. Books are charged to this key owner's Teneo credit balance.
  • TENEO_BASE_URL Optional Teneo API base URL. Defaults to https://teneo.io. Use https://staging.teneo.io for staging.
  • TENEO_SERVICE_KEY سري Optional ecosystem service key alternative to TENEO_API_KEY.
  • TENEO_ON_BEHALF_OF Required when using TENEO_SERVICE_KEY. Teneo user id whose credits are charged.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. teneo-book-mcp
  2. Tools
  3. What it costs
  4. Setup
  5. Spend semantics
  6. Not for
  7. Develop
  8. Links
  9. License

teneo-book-mcp

MCP server for Teneo. Lets any MCP-capable agent — Claude Desktop, Cursor, Claude Code, or your own — generate a complete, publish-ready non-fiction book: full manuscript, cover, and PDF/EPUB/DOCX files.

{
  "mcpServers": {
    "teneo-book": {
      "command": "npx",
      "args": ["-y", "teneo-book-mcp"],
      "env": { "TENEO_API_KEY": "tk_live_..." }
    }
  }
}

Tools

ToolWhat it does
teneo_capabilitiesDiscover auth, pricing, request shape, workflow, and output shape. Start here.
teneo_generate_bookStart a book (async) → returns a jobId. Runs ~45 min. Charged in credits.
teneo_book_statusPoll a job; when completed, returns download URLs for the cover and PDF/EPUB/DOCX.
teneo_generate_outlineGenerate an outline only, without running the full pipeline. Free.
teneo_research_nicheNiche research from a seed topic. Free.
teneo_generate_coverGenerate a cover only.
teneo_evaluate_bookRun quality evaluation on an existing generated book.

What it costs

Priced in Teneo credits. One credit is $69 singly, $59 each in a 3-pack, $44.90 each in a 10-pack; credits never expire.

requiredCredits = bookCredits + coverCredits + qualityCreditsReserve
bookCredits     = wordBandCredits(estimatedWordCount) x modelMultiplier(model_version)
estimatedWordCount = number_of_chapters x topics_per_chapter x subtopic_count x 350

A default request (12 chapters / 3 topics / 3 subtopics) estimates 37,800 words → 1.05 credits, about $72 at list. teneo_generate_outline and teneo_research_niche cost nothing, so validate direction before committing to a paid generation.

A funded Teneo balance is required before the first paid call — there is no pay-per-call endpoint yet. The live numbers, the full model-multiplier table, and the request schema are always at /api/agent/capabilities, which is authoritative if anything here disagrees with it.

Setup

Get a credential, then add the config block above to your MCP client.

  • Preferred (delegated): start at auth.teneo.io/auth.md, register for https://teneo.io/, have the user approve the claim, and exchange it for a delegated agent token. Pass it as TENEO_AGENT_TOKEN. The delegated user is charged.
  • Legacy: create an API key in your Teneo dashboard and pass TENEO_API_KEY=tk_live_....
  • Point at staging with TENEO_BASE_URL=https://staging.teneo.io.

Spend semantics

Worth knowing before you wire this into an autonomous loop:

  • Quoted before charged. A request that would exceed the balance returns 402 with the full quote and charges nothing — a safe way to read the exact price.
  • Idempotent. Send an Idempotency-Key header; replaying a request replays the original debit instead of charging twice.
  • Refunded on failure. A failed generation is refunded in full.
  • Async. A book takes ~45 minutes. Poll teneo_book_status, or pass callback_url for a completion webhook. Download URLs expire in ~1 hour; re-poll for fresh ones.

Not for

A single short answer, a blog post, or an article — answer those directly instead. Fiction and novels are not supported by this API.

Develop

npm test          # unit tests for the HTTP client (mocked fetch, no network)
npm start         # run the MCP server over stdio

client.mjs is a dependency-free HTTP client; server.mjs wraps it as MCP tools. Both mirror the published OpenAPI contract.

License

MIT

الأسئلة الشائعة

ما هو Teneo Book Generation؟

Publish-ready nonfiction books from a topic: manuscript, cover, PDF/EPUB/DOCX. Free outline to try.

كيف أثبّت Teneo Book Generation؟

يعمل على جهازك. في Claude Code: claude mcp add teneo-book-generation -e 'TENEO_API_KEY=<your teneo_api_key>' -e 'TENEO_BASE_URL=<TENEO_BASE_URL>' -e 'TENEO_SERVICE_KEY=<your teneo_service_key>' -e 'TENEO_ON_BEHALF_OF=<TENEO_ON_BEHALF_OF>' -- npx -y teneo-book-mcp@1.0.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Teneo Book Generation إلى مفتاح API؟

نعم. يتطلب TENEO_API_KEY, TENEO_SERVICE_KEY، وتضبطها في إعداداته.

هل Teneo Book Generation مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Teneo Book Generation؟

ينشره Traviseric. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.