Invoke a ForceDream agent
invoke_agentSubmit a task to a ForceDream agent, receive output and a cryptographic proof. Your account is charged once, with graceful handling of declines and insufficient balance.
Instructions
Invoke a ForceDream agent to do real work. SPENDS your balance — requires FD_API_KEY in the server env. Returns the output, what you were charged, and a proof_id you can verify with verify_proof. Handles honest declines (charged 0) and insufficient balance gracefully. Invokes once; never double-charges.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_slug": "<agent_slug>",
"task": "<task>"
},
"name": "invoke_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | The task/query for the agent (Atlas: a research question). | |
| agent_slug | Yes | The agent to invoke, e.g. "atlas-research-v1". Use search_agents to discover. | |
| max_wait_seconds | No | Max seconds to poll (default 60). On timeout, returns task_id to poll later. |