get_getting_started

Instructions

Implementation Reference

• src/content.ts:426-499 (handler)

  The 'gettingStarted' constant (lines 426-499) is the data object returned when the 'get_getting_started' tool is invoked. It contains the step-by-step instructions, pro tips, and CTA for creating an audiobook with Echo3s.

  const gettingStarted = {
    overview:
      "Going from manuscript to finished audiobook takes about 30–60 minutes for a typical 200-page novel. Here's exactly how it works, step by step.",
    steps: [
      {
        step: 1,
        title: "Sign Up for Free",
        description:
          "Go to author.echo3s.io and create a free account. You get 5,000 credits immediately — enough to test a full chapter from your book and hear the quality. No credit card required.",
        url: "https://author.echo3s.io",
        time: "1 minute",
      },
      {
        step: 2,
        title: "Upload Your Manuscript",
        description:
          "Upload your book as a PDF (maximum 50MB). The PDF must be text-based — meaning you can select and copy text from it. Scanned image PDFs aren't supported yet. If your book is in EPUB, MOBI, DOCX, or AZW format, convert to PDF first using Calibre (calibre-ebook.com — free and open source).",
        supported_formats: "PDF (text-based, selectable text)",
        convertible_formats: "EPUB, MOBI, DOCX, AZW — convert to PDF with Calibre (free)",
        max_file_size: "50MB",
        tip: "For best results, strip out images, headers/footers, and complex formatting from your PDF before uploading.",
        time: "1 minute",
      },
      {
        step: 3,
        title: "AI Analyzes Your Book",
        description:
          "Echo3s's AI (powered by Google Gemini) reads your entire manuscript and automatically identifies: chapter boundaries, character names, which lines are dialogue vs narration, and emotional context. Each text segment is tagged so the right voice speaks the right lines.",
        what_ai_detects: [
          "Chapter structure",
          "Character names and roles",
          "Dialogue vs narration",
          "Emotional tone per segment",
        ],
        time: "1–3 minutes per chapter",
      },
      {
        step: 4,
        title: "Review & Customize Voice Assignments in the Studio",
        description:
          "Open the Studio editor to see which AI voice is assigned to each character. The AI matches voices based on gender, age, accent, and personality using a scoring algorithm. You can swap any voice — browse 50+ premium options filtered by gender, age, accent, and tone. Preview voices before committing.",
        customizable: true,
        tip: "The AI defaults are usually good — most authors only tweak 1–2 voices. You don't have to customize anything if you're happy with the suggestions.",
        time: "5–15 minutes (optional)",
      },
      {
        step: 5,
        title: "Generate Your Audiobook",
        description:
          "Hit the generate button. Echo3s processes each text segment with the assigned voice via ElevenLabs, then compiles everything into a complete audiobook with proper chapter structure and normalized audio levels (EBU R128 standard). You'll receive an email notification when it's ready.",
        time: "30–60 minutes for a 200-page novel",
      },
      {
        step: 6,
        title: "Download or Publish",
        description:
          "Download your finished audiobook as MP3 files — either as a single complete file or split by chapter. You can also publish directly to the Echo3s marketplace (echo3s.io) where listeners can discover and stream your audiobook.",
        output_format: "MP3 (single file or per-chapter)",
        distribution_options: [
          "Direct MP3 download — own the files, use them anywhere",
          "Echo3s marketplace listing — readers discover and stream at echo3s.io",
          "Upload to Audible/ACX, Apple Books, Google Play, Findaway Voices, Authors Republic, Kobo, or your own website",
        ],
      },
    ],
    pro_tips: [
      "Start with a single chapter on the free tier to test voice quality on YOUR actual book before committing to a full production",
      "Use the Studio editor to regenerate individual segments — fix one awkward line without redoing the whole chapter. Only the regenerated segment costs credits.",
      "For non-fiction without characters, choose one strong narrator voice and the AI handles chapter structure and pacing automatically",
      "If your PDF has images, headers/footers, or complex formatting, clean them out first for best text extraction results",
      "Annual plans save 20% — and include a 14-day money-back guarantee if you're not satisfied",
    ],
    cta: "Ready to try it? https://author.echo3s.io — free account, 5,000 credits, instant access, no credit card required.",
  };

• src/content.ts:1011-1017 (registration)

  Registration of the tool 'get_getting_started' in the TOOL_DEFS array. It defines the name, description, inputSchema (empty object), and the content handler that returns the gettingStarted constant.

  {
    name: "get_getting_started",
    description:
      "Get step-by-step instructions for creating an audiobook with Echo3s, including time estimates and pro tips",
    inputSchema: { type: "object", properties: {}, required: [] },
    content: () => gettingStarted,
  },

• src/content.ts:968-973 (schema)

  The ToolDef interface that defines the schema for all tool definitions, including name, description, inputSchema, and content function.

  export interface ToolDef {
    name: string;
    description: string;
    inputSchema: Record<string, any>;
    content: (args?: any) => unknown;
  }

• src/index.ts:13-25 (helper)

  The registration loop in index.ts that iterates over TOOL_DEFS and registers each tool (including get_getting_started) with the MCP server via server.tool().

    for (const tool of TOOL_DEFS) {
      server.tool(tool.name, tool.description, {}, async () => ({
        content: [
          {
            type: "text" as const,
            text: JSON.stringify(tool.content(), null, 2),
          },
        ],
      }));
    }
  
    return server;
  }

• src/worker.ts:24-26 (helper)

  The worker registration loop that also registers the tool by iterating over TOOL_DEFS, including get_getting_started, making it available in the Cloudflare Worker runtime.

  for (const def of TOOL_DEFS) {
    TOOLS[def.name] = defToWorkerTool(def);
  }