Hello world — first paid call FAQ

[enot3615]

Q: My agent's Agent.new() printed an address. What now?

A: Send a tiny amount (~$0.10-$0.50) of MATIC + USDC to that address on
Polygon mainnet. The SDK will autonomously use it to pay 402 challenges.
Then run agent.pay(...) again — the response comes back as HTTP 200.

Q: I'm using Claude Desktop / Cursor / Windsurf and the tools don't show up.

A: Three things to check:

1. Did you restart the client after editing the config? Restart is required.
2. Is your claude_desktop_config.json (or equivalent) valid JSON? A trailing comma will silently kill loading.
3. Run npx @aifinpay/mcp directly in a terminal to confirm the package installs and starts.

Full client matrix here:
https://github.com/AiFinPay/sdk/blob/main/MCP_CONFIG.md

Q: How do I persist agent identity across MCP restarts?

A: Set AIFINPAY_AGENT_SECRET to a base58 Ed25519 secret you generated once:

node -e "const {Agent}=require('@aifinpay/agent'); const a=Agent.new(); console.log(a.secretB58)"

Add the printed secret to the MCP env block in your client config.

Q: Does AiFinPay hold my funds?

A: No. The agent's wallet is on-chain and you (or your agent) hold the
private key. Every payment is a direct user→splitter→merchant
transaction. AiFinPay never sees or touches the funds.

---

Got a different question? Reply below or open a new Q&A discussion.