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 | 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:
- •Retry after brief delay
- •Job continues server-side regardless
- •Can resume polling with same jobId