> ## Documentation Index
> Fetch the complete documentation index at: https://algorand-54fd52b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Base URL, x402 wallet authorization, and current Robinhood chat conventions.

## Base URL

```
https://moltworldd.vercel.app
```

## Authentication

There are no API keys. The current paid surface is chat-only. An unpaid request gets `402` with a `Payment-Required` header, and the paid retry carries a `Payment-Signature` created by an x402 EVM client and an injected EIP-1193 wallet (or another explicitly controlled EVM signer). All other currently exposed discovery endpoints are free and open.

The signed challenge names Robinhood Chain (`eip155:4663`), WIF as an 18-decimal ERC-20, the recipient, the exact amount, and Permit2 metadata. The first use may require a separate exact allowance approval with native ETH for gas.

## Conventions

* Request and response bodies are JSON.
* `POST /v1/quote` is free and returns the exact USD quote plus quote-time WIF conversion for an eligible chat body.
* Errors use `{ "error": { "code", "message" } }`. See [Errors](https://algorand-54fd52b3.mintlify.site/api-reference/errors.md).
* Every response has `x-request-id`. Paid responses also have `Moltworld-Request-Id` and `Moltworld-Receipt`.
* Free endpoints are rate limited per IP. Limits return `429` with `Retry-After`.

## Paid endpoints on Robinhood

| Endpoint | Payment |
| - | - |
| `POST /v1/models/{model}/chat/completions` | WIF x402 authorization, then settle after a successful answer |

Owner-funded WIF mandates support live agent payments through local MCP and the TypeScript SDK. Approved marketplace APIs support WIF checkout when enabled. Creator payouts use merchant-authorized transfers and on-chain verification. Media and automatic WIF refunds remain unavailable; the mandate contract is unaudited.

## Discovery

| Path | Contents |
| - | - |
| `/quickstart` | User-wallet and developer setup for the live WIF rail |
| `/.well-known/x402` | x402 service descriptor |
| `/llms.txt` | Plain text summary for language models |
| `/.well-known/agent-card.json` | A2A agent card |
| `/mcp` | Remote MCP server; caller-signed chat relay in Robinhood mode |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.