feat(skill): SolFoundry Claude Code Skill (MCP server) for bounty #844

[akuraposo]

Summary

Full Claude Code skill with MCP server (418 lines) exposing 10 SolFoundry API tools for bounty management directly from Claude CLI.

What this PR adds

• automaton/skills/solfoundry/mcp_server.py (12.1 KB, 271 lines) — MCP server
• automaton/skills/solfoundry/SKILL.md (3.3 KB) — installation + usage docs

Acceptance criteria (from #844)

• CLI commands for bounty CRUD operations — 10 tools: list, get, create, update, delete, claim, submit, batch_create, leaderboard, my_bounties
• Integration with SolFoundry API — full Bearer token auth + HTTP client
• Support for batch bounty creation from config files — JSON + YAML supported
• Claude Code skill format — MCP server with stdio transport, auto-discovered

Tools exposed

Read tools

• list_bounties(tier?, domain?, min_reward?, max_reward?, limit?) — filter open bounties
• get_bounty(bounty_id) — get full details
• get_leaderboard(limit?, period?) — top earners
• get_my_bounties(status?) — your active bounties

CRUD tools

• create_bounty(title, description, reward, tier, domain, acceptance_criteria?, deadline_days?)
• update_bounty(bounty_id, title?, description?, status?)
• delete_bounty(bounty_id) — only works on drafts

Workflow tools

• claim_bounty(bounty_id) — locks bounty to your account
• submit_solution(bounty_id, pr_url, description?) — submit PR

Batch tool

• batch_create_bounties(config_path, dry_run?) — JSON or YAML config file

Architecture

# MCP server using stdio transport
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

app = Server("solfoundry")

@app.list_tools()
async def list_tools() -> list[Tool]:
    return [Tool(name="...", description="...", inputSchema={...})]

@app.call_tool()
async def call_tool(name: str, arguments: Any) -> list[TextContent]:
    # Route to api_request() with bearer auth
    ...

Setup (3 commands)

# 1. Install dependencies
pip install mcp requests

# 2. Copy server
cp sol_foundry_mcp_server.py ~/.claude/mcp_servers/

# 3. Configure (~/.claude/mcp_servers/solfoundry.json)
{
  "mcpServers": {
    "solfoundry": {
      "command": "python3",
      "args": ["~/.claude/mcp_servers/sol_foundry_mcp_server.py"],
      "env": { "SOLFOUNDRY_API_KEY": "your-key" }
    }
  }
}

Example usage in Claude Code

"List all open T1 bounties with reward ≥ 100K"

"Create a new T1 frontend bounty for adding search, 150K $FNDRY"

"Claim bounty #830 and submit my PR at #1371"

"Use batch_create_bounties with my bounties.json"

File listing

File	Size	Purpose
automaton/skills/solfoundry/mcp_server.py	12.1 KB	MCP server with 10 tools
automaton/skills/solfoundry/SKILL.md	3.3 KB	Setup + usage docs

---

Closes #844
/claim #844