fix(docs): Round 4 — correct deprecated APIs, field names, and CLI commands

[aaitor]

Summary

• Fix 8 documentation issues across integration guides, development guides, and CLI reference
• Replace Payments({...}) with Payments.get_instance(PaymentOptions(...)) in MCP Python example
• Replace deprecated facilitator.settle()/facilitator.verify() with settle_permissions()/verify_permissions()
• Fix query-agents.mdx: reference payment-signature header instead of Authorization header
• Fix mcp.mdx: clarify payment token references (not Authorization tokens)
• Fix google-a2a.mdx: use canonical import from payments_py import Payments, PaymentOptions
• Fix CLI commands: nvm plans get → get-plan, nvm x402 get-token → nvm x402token get-x402-access-token
• Remove non-existent nvm agents list command

Test plan

• Verify no grep hits for deprecated patterns: facilitator.verify(, facilitator.settle(, Payments({
• Verify CLI commands match actual files in payments/cli/src/commands/
• Run mintlify build to validate docs

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR fixes 8 documentation issues related to deprecated APIs, incorrect header names, wrong import patterns, and outdated CLI command references across integration guides, development guides, and CLI reference documentation.

Changes:

• Replace deprecated facilitator.verify()/facilitator.settle() with verify_permissions()/settle_permissions()
• Update Python initialization pattern from Payments({...}) to Payments.get_instance(PaymentOptions(...))
• Consolidate Python imports to canonical pattern: from payments_py import Payments, PaymentOptions
• Correct x402 protocol header references from Authorization to payment-signature
• Update CLI commands to match actual command names (e.g., nvm plans get → nvm plans get-plan, nvm x402 get-token → nvm x402token get-x402-access-token)
• Remove nvm agents list command from CLI quick reference
• Update Claude Code skill installation instructions
• Add documentation guidelines about not modifying API reference docs directly

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/products/x402-facilitator/payment-models.mdx	Updates Python dynamic pricing example to use settle_permissions() with correct parameters
docs/integrations/nevermined-x402-ap2.mdx	Updates facilitator verification and settlement to use new API methods
docs/integrations/mcp.mdx	Fixes Python initialization pattern and clarifies payment token references (not Authorization tokens)
docs/integrations/google-a2a.mdx	Consolidates Python imports to canonical pattern
docs/integrate/patterns/charge-credits.mdx	Updates variable credit charging example to use settle_permissions()
docs/development-guide/query-agents.mdx	Corrects header name from Authorization to payment-signature for x402 protocol
docs/development-guide/build-using-nvm-skill.mdx	Replaces simple claude /install-skill command with manual git sparse-checkout instructions
docs/api-reference/cli/index.md	Updates CLI command names and removes nvm agents list from quick reference
CLAUDE.md	Adds notes about API reference docs being sourced from external repos

[Copilot]

The settle_permissions call is missing the required max_amount parameter. According to the x402 protocol documentation and the Nevermined Payments API, max_amount is a required parameter that specifies how many credits to burn during settlement. Add max_amount=str(credits_used) to the function call.

[aaitor]

@copilot open a new pull request to apply changes based on this feedback

[Copilot]

@aaitor I've opened a new pull request, #107, to work on those changes. Once the pull request is ready, I'll request review from you.