Skip to main content
The wizard is the fastest way to integrate. It’s an AI agent that implements the whole integration — the “Connect with Agentcard” OAuth flow plus per-user card issuance via the MCP server — 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

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

FlagWhat it does
--path <dir>Target a repo other than the current directory
-y, --yesSkip 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.