Bankr Agent - Job Workflow

Execute Bankr API operations using MCP tools with the asynchronous job pattern.

Core Pattern: Submit-Poll-Complete

1. Submit - Send prompt via bankr_agent_submit_prompt, receive job ID
2. Poll - Check status via bankr_agent_get_job_status every 2 seconds
3. Complete - Report results when status is terminal

MCP Tools

bankr_agent_submit_prompt

Submit a natural language prompt to start a job.

• Input: Natural language request (e.g., "Buy $50 of ETH on Base")
• Output: Job ID for tracking

bankr_agent_get_job_status

Check job status. Response includes:

• status: pending | processing | completed | failed | cancelled
• response: Text answer (when completed)
• transactions: Array of executed transactions
• statusUpdates: Progress messages during execution
• error: Error message (when failed)

bankr_agent_cancel_job

Cancel a running job.

Job Status States

| Status | Action | |--------|--------| | pending | Keep polling | | processing | Keep polling, report statusUpdates | | completed | Read response and transactions | | failed | Check error field | | cancelled | No further action |

Timing

• Poll interval: 2 seconds
• Typical completion: 30 seconds to 2 minutes
• Suggest cancellation: After 3+ minutes for simple queries

Output Guidelines

| Query Type | Output Format | |------------|---------------| | Price queries | State price clearly (e.g., "ETH is $3,245.67") | | Trades | Confirm amounts and transaction details | | Market analysis | Summarize key insights concisely | | Polymarket | State odds with context | | Balances | List holdings with USD values | | Errors | Explain clearly, suggest alternatives |

Status Update Handling

• Track last reported update count
• Only report NEW updates to avoid repetition
• Updates show agent progress (e.g., "Analyzing market data...")

Error Recovery

If polling fails:

1. Retry after brief delay
2. Job continues server-side regardless
3. Can resume polling with same jobId