Growaify is a machine-to-machine commerce platform: your agent discovers services, gets a binding quote, orders and pays via a hosted PayPal checkout link, and receives cryptographically signed digital deliverables — all via REST, MCP, or the Python SDK.
Start now ↓Download the SDK from growaify_sdk.py then run this example. No complex setup: just an agent ID and an email. For a zero-risk run, use an agent ID starting with SANDBOX_ on /sandbox.html — orders auto-complete with simulated settlement, no real payment.
from growaify_sdk import GrowaifyClient
client = GrowaifyClient(agent_id="my-agent")
# Discover services
services = client.discover()
# Order a service — pay via the hosted PayPal link in the response
order = client.order(service_id="task-worker",
email="agent@example.com")
print(order["payment_urls"]["paypal_hosted"])GET /api/v1/services — full catalog with agent pricing, SLA, and automation level, ready-to-parse JSON.
POST /api/v1/capabilities/negotiate — match your requirements (whatsapp, booking…) against the catalog within your budget.
POST /api/v1/quote — deterministic fixed price valid 7 days, retrievable, with optional 20% partner commission.
POST /api/v1/orders takes {service_id, email, agent_id?} and returns payment_urls.paypal_hosted — an Idempotency-Key header means retries never duplicate an order.
GET /api/v1/orders/{id} — order status, progress 0–100%, and deliverables.
GET /api/v1/orders/{id}/verification — SHA-256 checksum per deliverable to prove content integrity.
MCP server at POST /mcp: initialize, tools/list, ping and discover_capabilities are open without auth; the commerce tools require X-API-Key (or ?apiKey=). Full flow: discover_capabilities → create_binding_quote → purchase_service → track_order_telemetry.
// 1) create_binding_quote → returns quote_id (X-API-Key required)
{
"tool": "create_binding_quote",
"arguments": {
"service_id": "task-worker",
"quantity": 1
}
}
// 2) purchase_service → returns order + payment_urls.paypal_hosted
{
"tool": "purchase_service",
"arguments": {
"quote_id": "Q-...",
"email": "agent@example.com"
}
}| Tool | Function | Key parameters |
|---|---|---|
discover_capabilities open | Match your requirements (e.g. ["whatsapp","booking","multilingual"]) against catalog capabilities and return matching services at agent pricing. No API key required. | required_capabilities[] |
create_binding_quote | A binding, deterministic quote at agent price with volume discount tiers — valid 7 days and retrievable. | service_id, quantity?, partner_id? |
purchase_service | Create a commercial order from a binding quote — pay via the returned PayPal hosted link (x402 USDC deferred). | quote_id, email |
track_order_telemetry | Query order status, progress (0–100%), and prepared deliverables. | order_id |
query_trust_and_sla | Inspect the cryptographic checksum, refund policies, and attested uptime before purchasing. | — |
💡 From the SDK itself: client.mcp("discover_capabilities", {"required_capabilities": ["whatsapp"]})
🔑 Auth split: initialize, tools/list, ping and discover_capabilities are open; create_binding_quote, purchase_service, track_order_telemetry and query_trust_and_sla require an X-API-Key header (or ?apiKey=).
Deterministic fixed prices (locked until 2026-12-31), loaded live from GET /api/v1/services:
| Service | Agent price | Regular price | Billing | Fulfillment | SLA |
|---|---|---|---|---|---|
| ⏳ Loading catalog from /api/v1/services … | |||||
💡 Additional volume discounts: 10% at 10+ units, 20% at 100+ units · partner commission 20% automatic via partner_id · test risk-free in the Sandbox.
Everything is machine-verifiable. Your agent doesn't trust our word — it verifies itself.
Every digital deliverable is signed with SHA-256. Verify via GET /api/v1/orders/{id}/verification or client.verify(order_id) before accepting any output.
Safely retry the same request — the Idempotency-Key header prevents duplicate debits or execution on retry or network interruption.
Order lifecycle pending → paid → fulfilling → completed with strict recorded transitions and queryable 0–100% progress — no ambiguous states.
Hosted PayPal checkout is the primary rail — orders complete on verified payment only (PayPal webhook or operator confirm), never client assertion. x402 USDC is deferred; the agent wallet works only when the server sets DEPOSIT_API_TOKEN.
Every quote is refundable per SLA, with an accept / reject review loop that auto-re-executes on rejection.
A full test environment at /sandbox.html — agent IDs starting with SANDBOX_ or DEV_ run the complete loop and auto-complete via simulated settlement, no real payment.
Machine-readable files, ready for crawling and agent discovery: