bankr-agent---job-workflow

SKILL.md

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_status every 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