Teneo Book Generation — MCP server

Let any MCP-capable agent (Claude Desktop, Cursor, etc.) generate a complete, publish-ready non-fiction book — full manuscript + cover + PDF/EPUB/DOCX — through Teneo's agent API.

Tools

| Tool | What it does | |---|---| | teneo_capabilities | Discover auth, pricing, fields, workflow, use cases, output shape. | | teneo_generate_book | Start a book (async) → returns a jobId. ~45 min. Charged in credits. | | teneo_book_status | Poll a job; when completed, returns download URLs for cover + PDF/EPUB/DOCX. | | teneo_generate_outline | Generate an outline without running the full book pipeline. | | teneo_generate_cover | Generate a cover only. | | teneo_evaluate_book | Run evaluation on an existing generated book. | | teneo_research_niche | Start niche research from a seed topic. |

Setup

1. Get a key. In your Teneo dashboard create an API key (or POST /api/agent/keys while logged in). It's tied to your credit balance — top up at https://teneo.io/pricing.
2. Add to your MCP client. Example (Claude Desktop claude_desktop_config.json):

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

Ecosystem agents can instead set TENEO_SERVICE_KEY + TENEO_ON_BEHALF_OF. Point at staging with TENEO_BASE_URL=https://staging.teneo.io.

Develop / verify

npm test                 # unit tests (mocked fetch) for the HTTP client
TENEO_BASE_URL=https://staging.teneo.io TENEO_API_KEY=tk_live_... npm run integration-test   # real staging end-to-end (charges credits)
TENEO_API_KEY=tk_live_... npm start                  # run the MCP server (stdio)

client.mjs is the pure, testable HTTP client (no SDK deps); server.mjs wraps it as MCP tools. Mirrors https://teneo.io/openapi/agent-book-generation.yaml.

Publishing & promotion (how agents find this)

1. npm publish (teneo-book-mcp — unscoped, public by default).
2. Submit to MCP registries so agent builders discover it:
   • Official MCP registry, Smithery (smithery.ai), mcp.so, Glama (glama.ai/mcp).
3. Link it from https://teneo.io/llms.txt, the /for-agents page, and the OpenAPI.
4. Provide the config snippet above in docs + directory listings (copy-paste = adoption).

See docs/agents/AGENT-INTEGRATION.md for the full promotion plan and DX audit.

Registry metadata

• Official MCP Registry name: io.github.traviseric/teneo-book-mcp
• npm package: teneo-book-mcp
• Homepage: https://teneo.io/for-agents
• OpenAPI: https://teneo.io/openapi/agent-book-generation.yaml
• Source directory: scripts/agent-mcp
• Registry file: server.json
• Smithery config: smithery.yaml