Agent Skill

The skill is the fastest way to bootstrap a new agent into ZenithPay.

It executes onboarding in one session, then hands off to persistent MCP tools.

Skill URL

https://api.usezenithpay.xyz/skill.md

What the skill does

The skill guides your agent through a single onboarding session:

Step	What happens	How
1	Check for existing config	`cat ~/.zenithpay/config.json`
2	Create agent wallet	`POST /wallet/genesis` via curl
3	Store credentials locally	Writes `~/.zenithpay/config.json`
4	Register MCP server	`claude mcp add --transport http ...`
5	Activate policy	Human opens dashboard link, signs onchain
6	Verify policy active	`GET /limits` via curl

After this single session, the agent tells the user to restart. On the next session, the 6 zenithpay_* MCP tools appear natively — no skill re-reading required.

Loading the skill

Claude Code:

curl -s https://api.usezenithpay.xyz/skill.md

Any agent:

Fetch https://api.usezenithpay.xyz/skill.md as context and follow the onboarding steps in order.

After onboarding

The skill is not needed again. Tools persist via MCP. See MCP Server for the full tool reference and per-platform configuration.

Quick install prompt pattern

Recommended prompt shown in ZenithPay UI:

# Ask your AI agent: Read this skill and follow the onboarding instructions.
curl -s https://api.usezenithpay.xyz/skill.md

What the skill enforces at runtime

Once tools are installed, the skill's reasoning patterns guide the agent to:

Always call zenithpay_get_limits before any spend
Always call zenithpay_verify_merchant on new merchants
Include a meaningful intent string in every payment
Never retry a blocked payment — report the reason and stop
Never approve its own pending payments — those go to the human

Tools exposed

zenithpay_balance
zenithpay_pay_service
zenithpay_set_limits
zenithpay_ledger
zenithpay_get_limits
zenithpay_verify_merchant