Zero to working: agent skill

​

Prerequisites

• A SolvaPay account. Create one if you don’t have one.
• An AI coding tool that supports Agent Skills.
• Node.js with npx.

​

1. Install the skills

npx skills add https://solvapay.com

​

2. Give the project a sandbox key

npx solvapay@latest init

SOLVAPAY_SECRET_KEY=sk_sandbox_your_key_here

​

3. Ask the agent to integrate

Use SolvaPay to charge for POST /tasks in this Express app. Create a product
"Task API" with a Pro plan at $20/month. Unpaid customers should get a 402 with
a checkout link. Use the sandbox key in .env (SOLVAPAY_SECRET_KEY).

Use SolvaPay to monetize this MCP server. Keep list_docs free and put
deep_research on a Pro plan at $20/month. Use the sandbox key in .env
(SOLVAPAY_SECRET_KEY).

​

4. Check the result with a first paid call

1. Call the protected endpoint or tool as a new customer. You get a paywall: a 402 with checkoutUrl for an API, or a checkout link in the tool result for an MCP server.
2. Open the checkout link and pay with the Stripe test card 4242 4242 4242 4242, any future expiry date, and any CVC.
3. Call it again. It succeeds: this is your first paid call.

​

If the agent gets stuck

• Authentication and base URL: base URL, auth header, key prefixes.
• llms.txt: an index of every docs page as Markdown.
• Plans: the options[] format for plans.