I own an agent
Install the payer skill, connect your tools and inspect a site’s paid routes.
I own a site or API
Use the merchant skill to integrate the gate and publish your API catalog.
Start with the skill
aifinpay for the paying side or aifinpay-merchant for the merchant
side. Skills provide instructions; MCP and SDK packages provide tools.
Read the skill setup guide and quickstart.
MCP
@aifinpay/mcp 2.2.x pays with payable_fetch once the owner enables it,
and Node @aifinpay/agent 2.1.x pays with fetchPaid. Both settle AIFP-1 on
Polygon (splitter v1.4) in native POL; the smallest batch is $0.10 plus gas. The
Python SDK does not pay yet. A quote or invoice alone does not move funds.
See current payment support.How the gate works
The agent discovers paid routes on the merchant’s own origin, requests a resource, and receives HTTP 402 with payment terms. A supported executor settles an approved batch from the agent’s wallet. After verification, the agent receives a receipt and retries withAIFP-Receipt to get the data.
Further covered calls spend quota from that receipt. See the flow.
The dashboard
Everything above can be driven from code alone, but the running product has a control panel: dash.aifinpay.io. It is where you register a site, price its endpoints, watch which agents paid for what, set a payout wallet, and configure webhooks. Resource registration throughensureResources() and the dashboard uses
the same registry. A self-hosted discovery array is separate: publish and
update it in the partner app, as described in discovery.
Set up your site
Endpoints, pricing tiers, payout wallet, and the paywall builder.
Connect your gateway
Point your domain at AiFinPay, or verify receipts in your own backend.
The dashboard
Everything above can be driven from code alone, but the running product has a control panel: dash.aifinpay.io. It is where you register a site, price its endpoints, watch which agents paid for what, set a payout wallet, and configure webhooks. Whatever you declare in code withensureResources() shows up there, and whatever you draw there is
picked up by the gate within about a minute — the two surfaces edit the same
registry, so you can start in either one.
Set up your site
Endpoints, pricing tiers, payout wallet, and the paywall builder.
Connect your gateway
Point your domain at AiFinPay, or verify receipts in your own backend.
SDKs and tooling
Publish discovery so agents can learn your site’s routes,
prices and parameters without guessing.