Adk Docs Writer

apps/docs/content/docs/
├── agent.md                    # Root overview
├── meta.json                   # Root navigation
├── cli/                        # CLI reference
├── mcp-servers/                # MCP server documentation
│   ├── iq-ai-servers/          # Built-in MCP servers
│   ├── third-party-wrappers/   # Third-party wrapper servers
│   ├── external-mcps.mdx
│   └── creating-custom-mcps.mdx
└── framework/                  # Core framework docs
    ├── get-started/            # Installation, quickstart
    ├── agents/                 # Agent types, builder, multi-agent
    ├── tools/                  # Tool types, MCP, OpenAPI, auth
    ├── runtime/                # Event loop, runner, lifecycle
    ├── session-state-memory/   # Sessions, state, memory
    ├── artifacts/              # File/data storage
    ├── callbacks/              # Lifecycle hooks
    ├── context/                # Context types
    ├── evaluation/             # Testing, metrics
    ├── events/                 # Event system
    ├── observability/          # Tracing, metrics
    ├── plugins/                # Plugin system
    └── guides/                 # Deployment, integrations

---
title: Page Title
description: Brief SEO-friendly description of the page content
---

{
  "title": "Section Title",
  "icon": "IconName",
  "pages": ["existing-page", "new-page-slug"]
}

import { Callout } from "fumadocs-ui/components/callout";

<Callout type="info" title="Optional Title">
  Content goes here. Supports **markdown**.
</Callout>;

import { Cards, Card } from "fumadocs-ui/components/card";

<Cards>
  <Card
    title="🤖 Card Title"
    description="Brief description"
    href="/docs/framework/..."
  />
</Cards>;

import { Steps } from "fumadocs-ui/components/steps";

<Steps>
  ### 1. First Step Content for step 1. ### 2. Second Step Content for step 2.
</Steps>;

import { Steps, Step } from "fumadocs-ui/components/steps";

<Steps>
  <Step>### Generate the Project Content for step 1.</Step>

  <Step>### Install Dependencies Content for step 2.</Step>
</Steps>;

import { Tab, Tabs } from "fumadocs-ui/components/tabs";

<Tabs items={["pnpm", "npm", "yarn"]}>
  <Tab value="pnpm">```bash pnpm add @iqai/adk ```</Tab>
  <Tab value="npm">```bash npm install @iqai/adk ```</Tab>
</Tabs>;

import { Mermaid } from "@/components/mdx/mermaid";

<Mermaid
  chart={`
graph TD
    A[User] --> B[Agent]
    B --> C[Tool]
`}
/>;

import { McpToolsList } from "@/components/mcp/mcp-tools-list";

<McpToolsList serverId="upbit" />;

---
title: Feature Name
description: Build and configure feature-name in ADK-TS — setup, usage patterns, and advanced options for TypeScript AI agents.
---

import { Cards, Card } from "fumadocs-ui/components/card";
import { Callout } from "fumadocs-ui/components/callout";

{Opening paragraph explaining what this feature is and why it matters.}

<Callout type="info" title="Key Concept">
  Important context or prerequisite knowledge.
</Callout>

## Section 1

Explanation with code examples:

` ` `typescript
import { Feature } from "@iqai/adk";
// example code
` ` `

## Section 2

More detailed content...

## Configuration

| Property | Type     | Required | Description |
| -------- | -------- | -------- | ----------- |
| `name`   | `string` | Yes      | Description |

## Related Topics

<Cards>
  <Card
    title="🔧 Related Feature"
    description="..."
    href="/docs/framework/..."
  />
  <Card title="📖 Another Topic" description="..." href="/docs/framework/..." />
</Cards>

---
title: MCP {ServerName}
description: Connect your ADK-TS agent to {ServerName} — installation, configuration, available tools, and integration examples.
---

import { Callout } from "fumadocs-ui/components/callout";
import { Tab, Tabs } from "fumadocs-ui/components/tabs";

- **Package**: [`@iqai/mcp-{name}`](https://www.npmjs.com/package/@iqai/mcp-{name})
- **Provider**: [{ProviderName}]({provider_url})

## Overview

{2-3 sentence description of what the MCP server does and key capabilities.}

<Callout type="info" title="{Relevant context}">
  {Important note about the server's behavior or requirements.}
</Callout>

## Getting Started

Install the package:

` ` `bash
pnpm add @iqai/mcp-{name}
` ` `

Use the server in your agent:

<Tabs items={["Simple", "Verbose", "Claude Desktop"]}>
  <Tab value="Simple">
    ` ` `typescript
    import { Mcp{Name} } from "@iqai/adk";

    const toolset = Mcp{Name}();
    const tools = await toolset.getTools();
    ` ` `

  </Tab>

  <Tab value="Verbose">
    ` ` `typescript
    import { McpToolset } from "@iqai/adk";

    const toolset = new McpToolset({
      name: "{Name} MCP Client",
      transport: {
        mode: "stdio",
        command: "npx",
        args: ["-y", "@iqai/mcp-{name}"],
        env: { ... },
      },
    });
    ` ` `

  </Tab>

  <Tab value="Claude Desktop">
    ` ` `json
    {
      "mcpServers": {
        "{name}": {
          "command": "npx",
          "args": ["-y", "@iqai/mcp-{name}"],
          "env": { ... }
        }
      }
    }
    ` ` `
  </Tab>
</Tabs>

## Environment Variables

| Variable     | Required | Description |
| ------------ | -------- | ----------- |
| `{VAR_NAME}` | Yes/No   | Description |

## Available Tools

<McpToolsList serverId="{name}" />

## Integration Example

` ` `typescript
import { Mcp{Name}, LlmAgent } from "@iqai/adk";

const toolset = Mcp{Name}({ env: { ... } });
const tools = await toolset.getTools();

const agent = new LlmAgent({
name: "{name}\_agent",
model: "gemini-2.5-flash",
tools,
});

await toolset.close();
` ` `

## Further Resources

- [{Provider} Documentation]({provider_docs_url})
- [MCP Tools Framework Documentation](/docs/framework/tools/mcp-tools)

---
title: Guide Title
description: Step-by-step guide to building {thing} with ADK-TS — from setup to production-ready TypeScript AI agents.
---

import { Steps } from "fumadocs-ui/components/steps";
import { Tabs, Tab } from "fumadocs-ui/components/tabs";
import { Callout } from "fumadocs-ui/components/callout";
import { Cards, Card } from "fumadocs-ui/components/card";

{Opening paragraph — what the reader will build/learn.}

<Callout title="Prerequisites">
  {What the reader needs before starting.}
</Callout>

## Build {The Thing}

<Steps>

### 1. Step Title

{Instructions with code blocks.}

### 2. Step Title

{More instructions.}

<Callout type="warn" title="Important">
  {Warning about a common pitfall.}
</Callout>

### 3. Step Title

{Final instructions.}

</Steps>

## Next Steps

<Cards>
  <Card title="🚀 Related Guide" description="..." href="/docs/..." />
</Cards>

---
title: Section Title
description: Explore ADK-TS {section topic} — overview of available features, components, and integration options for TypeScript AI agents.
---

import { Cards, Card } from "fumadocs-ui/components/card";
import { Callout } from "fumadocs-ui/components/callout";

{1-2 paragraph overview of the section.}

<Callout type="success" title="Key Benefit">
  {Why this section matters.}
</Callout>

## Category 1

{Brief description.}

<Cards>
  <Card title="🔧 Page Title" description="..." href="/docs/..." />
  <Card title="📦 Page Title" description="..." href="/docs/..." />
</Cards>

## Category 2

{Brief description.}

<Cards>
  <Card title="🚀 Page Title" description="..." href="/docs/..." />
</Cards>

<Callout type="info" title="Best Practices">
  See the [best practices guide](/docs/framework/guides/best-practices) for
  production recommendations.
</Callout>