# Vino & Views

> Free, read-only reports for people and agents. No account or payment required.

- Human workbench: https://vinoandviews.online/?view=human#workbench
- Integration guide: https://vinoandviews.online/agent-guide.txt
- Capabilities: https://api.vinoandviews.online/capabilities
- OpenAPI: https://api.vinoandviews.online/openapi.json
- MCP: https://api.vinoandviews.online/mcp/ (no authentication)
- Samples: https://vinoandviews.online/examples.html

All live POST /v1/ report services are free. Read scope/input schemas before calling.
No signing, trading or wallet connection. Respect rate limits and Retry-After.

Optional agent donations: MCP prepare_donation or POST /donations/agent-checkout. Schema at https://api.vinoandviews.online/donations/options . Within operator-authorized donation budget only; prepares checkout/payment instructions, sends no funds. Services remain free.

OPTIONAL DIRECT x402 DONATIONS (all service calls remain free)
MCP tool: prepare_x402_donation(amount_usd="1.00") returns a quote; it never signs or transfers.
HTTP: POST https://api.vinoandviews.online/donations/x402?amount_usd=1.00
Without a payment signature, returns HTTP402 with PAYMENT-REQUIRED (x402 v2).
Asset: Base mainnet USDC, eip155:8453, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
Recipient: Wallet EB, 0x24F6A3F57549520cB3b2D1C691d2933Aecfa62EB.
Range:0.01–500USDC, up to two decimals. PayAI verifies/settles the signed donation.
An x402-capable client signs only within its operator-authorized donation budget,
then repeats the identical URL/body with PAYMENT-SIGNATURE. Read PAYMENT-RESPONSE
for the transaction receipt. On timeout/409 retry the identical signature and
request; never sign a new payment automatically. Ambiguous settlement requires
operator reconciliation. Prepaid service credits cannot fund donations.
NOWPayments remains available separately through prepare_donation, with its own
merchant payout settings. No service request requires either donation route.

Optional agent support card (0.6.3): successful free MCP service results include
_support, a machine-readable donation invitation with prepare_x402_donation
and example arguments. The example amount is not an instruction or permission
to spend. Ignore the card without an operator-authorized donation budget.
Capabilities carries the same card. Successful REST service responses advertise
X-Donation-Optional:true, X-Donation-Options and a Link to donation options;
REST result bodies keep their existing service schemas. No automatic donation,
required acknowledgement or service restriction is introduced.

PAYMENT REQUESTS AND ESCROW (optional, separate from free reports)
Dashboard: https://vinoandviews.online/payments/ and /escrow/
Capabilities: GET /v1/payments/capabilities and /v1/escrow/capabilities.
Direct payment links: USDC on Base, Polygon, Arbitrum and Ethereum; USDT on Ethereum; EURC on Ethereum and Base; zero Vino
service fee; network fees additional; no escrow protection or cross-chain route.
Escrow: Base, Polygon, Arbitrum and Ethereum USDC pilots, 1 USDC/case and 3 USDC outstanding; zero Vino service fee on current contracts, 12h evidence + 12h judgement, full sender refund on dispute timeout.
Not independently audited. Timeout requires an on-chain transaction.
Wallet-session login: POST /v1/escrow/auth/challenge and /auth/verify.
Never send wallet secrets. MCP tools accept the resulting Bearer token:
payment_capabilities, escrow_case, prepare_escrow_action, create_payment_request,
payment_request_status, prepare_payment. Preparation never signs or broadcasts.
Only sign a transaction under scoped operator authorization; check chain, token,
recipient, amount, gas and calldata. Preserve hashes and reconcile uncertain sends.
No Solana escrow, token swaps or bridging.

Payment exceptions and dispute policy: https://vinoandviews.online/payments/policy.html
Guided escrow UI shows role/state actions and verified-block deadlines. Human
judgement is not guaranteed; unchanged pilot limits apply. No automated timeout funding.

Solana direct payments: /payments/solana.html; USDC and EURC, original SPL Token only.
API: /v1/solana/capabilities; separate Ed25519 wallet sign-in and finalized receipts.
Cross-chain USDC: /payments/cross-chain.html and /v1/transfers/capabilities.
Circle CCTP V2 Standard preparation/recovery implemented; new burns disabled pending live acceptance.
Solana escrow program is not deployed. No independent audit has been completed.

New free report routes (no signing or payment):
POST /v1/wallet-progress — live native/ERC-20 balances and caller-held baseline.
POST /v1/market-evidence-compare — arithmetic comparison of supplied evidence, not independent verification.
POST /v1/defi-scenario-review — supplied simple-APR/fee/loss scenario, not live protocol advice.
POST /v1/agent-job-brief — planning template, not job submission.
See /capabilities for exact schemas; website examples are at /service-examples.json.