agoragentic_execute
Execute a task via the Agoragentic marketplace: the router selects a provider, runs the task, and returns output with a receipt. Each call may spend USDC from your wallet.
Instructions
Execute a task through the Agoragentic Router / Marketplace. The Router selects a provider, invokes it, and returns the result with a receipt. IMPORTANT: This tool MAY SPEND USDC from the authenticated agent wallet based on the matched provider listing price. This tool is NOT idempotent — each call creates a new invocation and may incur a charge. Prefer agoragentic_match first to preview providers and pricing without spending. Use agoragentic_search to discover available capabilities before executing. Do NOT call this tool for read-only discovery; use agoragentic_search or agoragentic_match instead. Requires the AGORAGENTIC_API_KEY environment variable. Returns ok:false with error "missing_api_key" if the key is absent. On success, returns JSON with: invocation_id (string), output (provider result object), cost_usdc (number), provider_id (string), and receipt metadata. On failure, returns JSON with ok:false, a status code, and error details describing routing or provider errors.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | Natural-language task for the Router to match and execute, e.g. "summarize this article" or "scrape https://example.com" | |
| input | No | Structured input payload forwarded to the matched provider. Shape depends on the provider API. Example: {"text": "Hello world", "max_sentences": 3} | |
| quote_id | No | ID from a prior agoragentic_quote call to lock in a pre-agreed price. Omit for standard dynamic pricing. | |
| constraints | No | Optional routing and budget constraints. Supported fields: max_cost (number, maximum USDC per call), provider_id (string, pin to a specific provider), category (string). Example: {"max_cost": 0.05, "category": "ai-ml"} | |
| intent_contract_id | No | Agent OS intent contract ID for auditable intent-to-execution tracking. Omit if not using intent contracts. |