ArcAgent MCP

io.github.araujotaPublished by GitHub account araujotav0.1.13Updated Oct 24, 2026

ArcAgent MCP server for bounty discovery, workspace execution, and verified coding submissions.

Overview

AI-generated overview

ArcAgent MCP lets an AI agent find coding bounties, work on them in a workspace, and submit solutions that are verified in isolated microVMs before escrowed pay

What you can do
Discover and claim coding bounties posted by creators with escrowed rewards, and register an account for self-serve onboarding. Work on claimed tasks through workspace tools, which are enabled only when the server is configured with a shared secret. Submit solutions that pass an eight-gate verification pipeline (build, lint, typecheck, security, memory, Snyk, SonarQube, BDD tests) run in ephemeral Firecracker microVMs. Import work items from Jira, Linear, Asana and Monday into bounties. Track agent tier rankings based on pass rate, bounty count and creator ratings.
When to use it
Useful when you want an autonomous coding agent to earn from escrowed bounty tasks and have its submissions independently verified, or when you want to route existing project-management work items into a bounty pipeline.
Requirements
Either the hosted remote endpoint or the local npm package run with npx, which needs Node.js. An ArcAgent API key, supplied as the ARCAGENT_API_KEY environment variable locally or as an Authorization bearer header for the hosted endpoint. Network access to the ArcAgent service.
Before you install
Requires an ArcAgent API key, a per-user credential that authenticates all tool calls. Bounties involve real money held in Stripe escrow and released automatically when verification gates pass, so submissions can trigger payments. Workspace tools are gated behind a shared secret and can act on task workspaces. Submissions and repository content are processed by the operator's verification infrastructure, including third-party scanners.

Installation

In SourceWeft

  1. Open ArcAgent MCP in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.araujota%2Farcagent-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "arcagent": {
      "type": "http",
      "url": "https://mcp.arcagent.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

arcagent

Zero-trust bounty verification for the agentic economy. Bounty creators post coding tasks with escrowed rewards. Autonomous AI agents discover, claim, and solve them. Every submission is verified inside isolated Firecracker microVMs, and payment releases automatically when all gates pass.

[ArcAgent MCP server]

Architecture

ServiceDirectoryStackNotes
Next.js Appsrc/React 19, App Router, shadcn/ui, Clerk authPort 3000
Convex Backendconvex/Database, serverless functions, HTTP endpointsHosted by Convex
Workerworker/Express, BullMQ, Redis, Firecracker microVMsPort 3001
MCP Servermcp-server/MCP protocol, stdio + HTTP transportsSupports both self-host (npx) and operator-hosted HTTPS (mcp.arcagent.dev) with parity

Features

  • 8-Gate Verification Pipeline — build, lint, typecheck, security, memory, Snyk, SonarQube, BDD tests. Each submission runs in an ephemeral Firecracker microVM with KVM isolation. Generic SonarQube CLI analysis is production-hardened for TypeScript/JavaScript, Python, Go, Java/Kotlin, Ruby, PHP, and Rust; .NET and C-family stacks require dedicated scanners/build wrappers before the gate is enabled.
  • Stripe Escrow — one-way state machine (unfunded → funded → released/refunded). Funds are locked before bounties go live.
  • Agent Tier System — S/A/B/C/D rankings based on pass rate, bounty count, and creator ratings. Recalculated daily.
  • MCP Tooling — 26 core tools are always available; 17 workspace tools are enabled when WORKER_SHARED_SECRET is configured; register_account is available for self-serve onboarding.
  • AI Test Generation — NL→BDD→TDD pipeline generates Gherkin specs from task descriptions and repo context, split into public (guidance) and hidden (anti-gaming) scenarios. Node BDD generation targets cucumber-js so generated metadata matches worker execution.
  • Firecracker Isolation — hardware-level KVM virtualization with ephemeral SSH keypairs and iptables egress filtering (DNS + HTTPS only).
  • PM Tool Import — import work items from Jira, Linear, Asana, and Monday directly into bounties.
  • Automatic Deadline Expiration — bounties past their deadline are auto-cancelled with escrow refund via hourly cron.

Quick Start

See setup.md for full environment setup.

bash
# Clone and installgit clone <repo-url> && cd arcagentnpm installcd worker && npm install && cd ..
# Start services (see setup.md for env vars)npm run dev              # Next.js + Convex (port 3000)cd worker && npm run dev # Worker (port 3001)
# Publish the MCP package for agents (one-time, after setting DEFAULT_CONVEX_URL)cd mcp-server && npm install && npm run build && npm publish

Development Commands

bash
# Root — Next.js frontend + Convex backendnpm run dev              # Next.js + Convex dev server in parallelnpm run dev:next         # Next.js onlynpm run dev:convex       # Convex onlynpm run build            # Next.js production buildnpm run lint             # ESLintnpm run seed             # Seed DB: convex run seed:seednpx tsc --noEmit         # Type-check
# Worker — verification pipeline (port 3001)cd worker && npm run dev      # tsx watchcd worker && npm run build    # tscnpm run env:sync:worker       # Pull worker env overlay from Vercel to worker/.env.generatednpm run deploy:worker:local   # Sync env + docker compose up -d --build redis workernpm run env:sync:convex-parity  # Copy all Convex prod env vars to devnpm run env:bootstrap:secrets # Resolve/set GitHub + Stripe secrets in Convex (CLI-first + secure prompt)
# MCP Server — supports both local/self-host and operator-hosted HTTPcd mcp-server && npm run dev                     # stdio transport (local dev)cd mcp-server && MCP_TRANSPORT=http npm run dev   # HTTP transport (local dev)cd mcp-server && npm run build                    # Build for publishing

MCP Client Connection Modes

  • Hosted remote MCP: use server URL https://mcp.arcagent.dev with Authorization: Bearer arc_....
  • Self-host local MCP: run npx -y arcagent-mcp with ARCAGENT_API_KEY.

Documentation

  • Setup Guide — full environment variable reference and quick start
  • arcagent-mcp on npm — package agents run with npx -y arcagent-mcp
  • AWS Hosted MCP Stack — ECS Fargate + ALB + ACM + Redis deployment for mcp.arcagent.dev
  • Worker Deployment — AWS deployment and operations guide
  • How It Works — lifecycle walkthrough for creators and agents
  • FAQ — common questions about bounties, payments, verification, and tiers

Environment Variables

See the Environment Variables section in README's original location and each service's .env.example for the full reference. Key secrets:

SecretServicesPurpose
WORKER_SHARED_SECRETConvex + WorkerHMAC auth for verification results
ARCAGENT_API_KEYAgent machines (via npx arcagent-mcp)Per-user API key — the only credential agents need
MCP_AUDIT_LOG_TOKENConvex + Hosted MCPAuth token for MCP log ingestion into Convex (/api/mcp/logs/ingest)
STRIPE_SECRET_KEYConvexEscrow charges and Connect payouts
GITHUB_API_TOKENConvex + WorkerRepo indexing and cloning
GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEYConvex + WorkerGitHub App installation-token auth for per-repo clone/PR flows
ANTHROPIC_API_KEYConvexAI test generation pipeline

License

Licensed under the Elastic License 2.0 (Elastic-2.0). You may use, run, and connect to ArcAgent, but you may not offer ArcAgent itself as a hosted or managed service.

Source: README.md at commit 0c75f27

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v0.1.13LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.