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

# The Wizard

> Implement Agentcard in your codebase with one command

The wizard is the fastest way to integrate. It's an AI agent that implements the whole integration — the "Connect with Agentcard" [OAuth flow](/companies/authentication/oauth) plus per-user card issuance via the [MCP server](/companies/mcp/overview) — directly in your repository, then proves it by issuing a real card in sandbox.

You don't bring an API key for the agent: the wizard runs on Agentcard's own tokens through a hosted gateway.

## Run it

```bash theme={null}
npm install -g agent-cards-admin
agent-cards-admin login       # one-time, magic link
cd /path/to/your/app
agent-cards-admin wizard
```

The wizard:

1. Forces **sandbox** mode for the run — no real money can move.
2. Detects your stack (framework, package manager, any existing OAuth or MCP code) and asks for consent before touching files.
3. Makes minimal, idiomatic edits following the Agentcard integration playbook.
4. Verifies the integration by issuing a sandbox card, then prints a summary of every file it changed.

Review the diff and commit. That's the whole integration.

## Options

| Flag           | What it does                                   |
| -------------- | ---------------------------------------------- |
| `--path <dir>` | Target a repo other than the current directory |
| `-y, --yes`    | Skip the consent prompt                        |

## Good to know

* **Re-running is safe.** The wizard detects an existing integration and continues or fixes it — it never duplicates.
* **You review everything.** Edits happen locally; nothing ships until you commit.
* **It ends in sandbox.** Production keys come with an org subscription (`agent-cards-admin subscribe`) when you're ready to go live.

Prefer to wire things up yourself? Head to [Manual Implementation](/companies/getting-started/manual-implementation).