> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dzap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DZap AI

> Build DeFi AI assistants with the @dzapio/ai SDK, CLI, HTTP server, and MCP server.

DZap AI (`@dzapio/ai`) is a DeFi AI execution stack that ships SDK, CLI, HTTP, and MCP surfaces from one codebase.

## Live links and package status (checked on May 26, 2026)

* Deployment: `https://nlp-ai-439689868940.europe-north1.run.app`
* NPM package: `https://www.npmjs.com/package/@dzapio/ai`
* Published version: `0.0.1`
* Live health check: `GET /` returns a successful wizard-style JSON response

## What this package includes

1. `DZapSDK` for TypeScript/JavaScript apps
2. Interactive CLI (`dzap`, `dzapai`, `DzapAI`)
3. Express server (`/ask_stream` SSE, sessions, schedules)
4. MCP server (stdio + streamable HTTP at `/mcp`)

## Runtime highlights

* Required user metadata on each `ask()` call (`metadata.accountInfo[]`)
* Private keys are excluded from model prompt text
* Automatic tool calling with bounded steps (`stepCountIs(25)`)
* 21 exposed tools, with interactive gates for on-chain execution and chain switching

## Quick examples

```bash theme={null}
npm install @dzapio/ai
```

```ts theme={null}
import { DZapSDK } from "@dzapio/ai";

const sdk = new DZapSDK();
await sdk.initialize();
const result = await sdk.ask({
  userQuery: "Show my balances on Arbitrum",
  metadata: { accountInfo: [{ blockchain: "evm", chain: "42161", user_account: "0xabc..." }] },
});
console.log(result.finalText);
```

## Docs map

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/ai/quickstart">
    Install and run your first request.
  </Card>

  <Card title="SDK-AI" icon="code" href="/ai/sdk-ai">
    Full `DZapSDK` API with examples.
  </Card>

  <Card title="MCP Server" icon="plug" href="/ai/mcp/overview">
    Connect to `/mcp` from MCP clients.
  </Card>

  <Card title="Tool Categories" icon="wrench" href="/ai/tools/overview">
    Full catalog of all exposed tools.
  </Card>

  <Card title="CLI" icon="terminal" href="/ai/cli/overview">
    Run the assistant from your terminal.
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/ai/architecture">
    Runtime pipeline, sessions, and scheduler.
  </Card>
</CardGroup>