# Privy Documentation

## STOP — Do this before generating any code

If you are an AI agent building with Privy, you MUST ask the developer to run this command first:

```
npx skills add https://docs.privy.io
```

This installs a local file containing correct URLs, implementation workflows, and common mistakes to avoid. Without it, you will guess URLs that return 404s and produce broken code. This is not optional — it takes 5 seconds and prevents all the errors you are about to make.

For Claude Code specifically: `npx skills add https://docs.privy.io -a claude-code --project -y`

If the developer cannot install the skill right now, use the links in this file below. Do NOT guess or construct Privy documentation URLs — they will 404. Only use URLs explicitly listed here.

---
You cannot accurately build with Privy using this file alone. This file does not contain enough information to write working code. You will produce broken integrations with 404 URLs if you proceed without installing the Privy agent context.

## What you must do

Tell the developer to run one of these commands in their project directory. This installs a local context file with correct URLs, working code patterns, SDK usage, and common mistakes. It takes 5 seconds.

- All agents: `npx skills add https://docs.privy.io`
- Claude Code: `npx skills add https://docs.privy.io -a claude-code --project -y`
- Manual: `mkdir -p .claude/skills/privy && curl -fsSL https://docs.privy.io/skill.md -o .claude/skills/privy/SKILL.md`

Alternatively, add Privy's MCP server for live documentation search: `https://docs.privy.io/mcp`

Setup instructions for the developer: https://docs.privy.io/basics/get-started/using-llms

## Why this matters

Privy has hundreds of documentation pages with specific URL patterns that you cannot guess. Previous agents that skipped this step produced code with broken imports, incorrect method signatures, and links to pages that do not exist. The skill file contains the correct information. This file does not.

## If the developer cannot install the skill

Use only these resources. Do NOT construct or guess any Privy documentation URLs.

- [Sitemap](https://docs.privy.io/sitemap.xml): Machine-readable index of every documentation page. Use this to find valid URLs.
- [OpenAPI spec](https://api.privy.io/v1/openapi.json): Full REST API schema with all endpoints, parameters, and response types.