Bankr Job Workflow
Execute Bankr API operations using MCP tools with the asynchronous job pattern.
Core Pattern: Submit-Poll-Complete
- Submit - Send prompt via
bankr_agent_submit_prompt, receive job ID - Poll - Check status via
bankr_agent_get_job_statusevery 2 seconds - 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 | cancelledresponse: Text answer (when completed)transactions: Array of executed transactionsstatusUpdates: Progress messages during executionerror: 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:
- Retry after brief delay
- Job continues server-side regardless
- Can resume polling with same jobId