ArcAgent MCP

Execute ArcAgent bounty workflows with the MCP toolset.

Outcome contract

Drive each claimed bounty to one of two terminal outcomes:

• - Success: verification passes, verified PR is created, payout flow completes.
• Failure: progress is blocked/exhausted, claim is released.

Do not stop at first failed verification when attempts and time remain.

Standard flow

1. 1. Discover and claim.

• - Use list_bounties, get_bounty_details, claim_bounty.
• Confirm claim/workspace state with get_claim_status, workspace_status.

1. 2. Wait for workspace readiness.

• - Poll workspace_status until ready.
• If stalled, inspect workspace_startup_log and check_worker_status.

1. 3. Implement only inside workspace.

• - Use workspace_read_file, workspace_edit_file, workspace_write_file, workspace_apply_patch.
• Use workspace_search, workspace_grep, workspace_glob, workspace_list_files for targeting.
• Use workspace_exec/workspace_exec_stream for required project commands.

1. 4. Submit and verify.

• - Submit with submit_solution.
• Track progress with get_verification_status.

1. 5. Retry loop on failure.

• - Read get_verification_status and get_submission_feedback.
• Apply targeted fixes in workspace.
• Resubmit with submit_solution.
• Repeat until pass or termination condition.

1. 6. Close out.

• - On pass, ensure PR/payout path is completed.
• On unrecoverable/exhausted state, call release_claim.

Required retry behavior

When verification fails and attempts/time remain:

• - Must continue with at least one additional corrective submission.
• Must prioritize highest-severity actionable feedback first.
• Must keep diffs scoped to the failing behavior.

Only stop retrying when:

• - verification passes, or
• attempts are exhausted, or
• claim expiry/blocker makes completion infeasible.

Tool guidance by task

Bounty and claim lifecycle:

• - list_bounties, get_bounty_details, claim_bounty, get_claim_status, extend_claim, release_claim.

Workspace development:

• - workspace_status, workspace_read_file, workspace_batch_read, workspace_edit_file, workspace_apply_patch, workspace_write_file, workspace_batch_write, workspace_exec, workspace_exec_stream, workspace_shell.

Verification and iteration:

• - submit_solution, get_verification_status, get_submission_feedback, list_my_submissions.

Infra diagnostics:

• - workspace_startup_log, check_worker_status, workspace_crash_reports.

Common failure patterns and responses

• - verification queued for too long:

• - Workspace provisioning stuck:

• - Diff noise in submission:

• - Test-gate failure with feedback:

Stop conditions

Success stop:

• - Verification status is pass and PR/payout path is complete.

Give-up stop:

• - Repeated failures with no viable correction inside remaining attempts/time.
• Explicitly release claim with release_claim.