# XMTP agent

CLAUDIA has an XMTP agent — a wallet-to-wallet chat endpoint you can DM from any XMTP-compatible client (Coinbase Wallet's chat, Converse, the xmtp.chat web client, etc.). Send it a message, get back a CLAUDIA-flavored response: roast a wallet, analyze a token, check market conditions. Same brain as the web app, wrapped in chat.

## What you can ask it

The agent understands a handful of natural-language commands:

* `roast 0x...` — roast a wallet by address
* `analyze $TOKEN` — short analysis of a token (chart, fundamentals, signals)
* `market scan` — current scan summary
* `my portfolio` — analyze the sender's own wallet (no address needed)
* `full analysis $TOKEN` — deeper multi-agent analysis

Anything you send that doesn't match a command gets handled as a general DeFi question.

## How to use it

Install any XMTP-compatible wallet (Coinbase Wallet, Converse), or use [xmtp.chat](https://xmtp.chat) in a browser. Make sure your client is on the production XMTP network. DM the CLAUDIA agent's address — you can grab it from the app's Contact page. Type your command. Wait a couple seconds.

## Cost and rate limits

**Free tier:** 3 queries per wallet per day. No tokens required.

**Token-gated unlimited:** wallets holding 25,000 `$CLAUDIA` or more get unlimited queries. The check is automatic on every message — there's no opt-in; hold the tokens and the cap lifts.

There's no credit deduction on the XMTP side. Token-gated unlimited is the paid unlock; the 3/day allowance is the free sample.

## Plain text only

XMTP clients render raw text. Markdown and HTML don't render, so the agent replies in structured plain text: uppercase headers, blank-line separators, Unicode arrows (`→`) and bullets (`•`). If you're building a client that reads CLAUDIA's XMTP responses, expect prose, not markup.

## Common gotchas

**Network mismatch.** The agent lives on XMTP's production network. If your client is on the dev network, messages won't arrive. Most consumer wallets default to production — if you've got a dev build, switch it.

**Response length.** Some XMTP clients truncate at around 1,000 characters. The agent keeps replies compact, but for very long outputs (e.g. full analysis) you may see it split across two messages.

**Address normalization.** Your connected EVM address is what CLAUDIA checks for the token gate. Make sure your XMTP identity is registered to the wallet holding your `$CLAUDIA`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.claudia.wtf/for-developers/xmtp-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.