feat(agents): SolFoundry Claude Code Skill — MCP Server + SKILL.md (Bounty #844)

[Ikalus1988]

SolFoundry Bounty T2: Claude Code Skill (Bounty #844)

Reward: 600K $FNDRY | Tier: T2 | Domain: Agent

What This PR Delivers

A complete, production-ready Python MCP server + SKILL.md for SolFoundry bounty management directly from Claude Code.

Files Added

File	Lines	Purpose
agents/claude_code_skill/SKILL.md	185	Claude Code integration guide (skill registration, tool usage, examples)
agents/claude_code_skill/solfoundry_mcp.py	550	Full Python MCP server with 12 tools
agents/claude_code_skill/README.md	85	Quick-start guide

12 MCP Tools

• list_bounties — Browse/filter with tier/domain/status/pagination
• get_bounty — Get bounty details by ID
• search_bounties — Keyword search
• create_bounty — Create with full metadata (tier, reward, criteria, deadline)
• update_bounty — Update any field
• delete_bounty — Cancel bounty
• batch_create_bounties — From JSON config file or inline JSON
• submit_solution — Submit PR as solution
• get_submission — Check submission status
• get_contributor_stats — Contributor profile
• get_leaderboard — Top contributors
• verify_escrow — On-chain escrow check

Differences from Other PRs

• vs feat: Claude Code Skill for SolFoundry Bounties (Bounty #844) #1191: This PR includes the SKILL.md that feat: Claude Code Skill for SolFoundry Bounties (Bounty #844) #1191 is missing — critical for Claude Code skill registration
• vs feat: implement bounty CRUD, batch operations, and MCP server for Claude Code ( Issue #844) #1250: feat: implement bounty CRUD, batch operations, and MCP server for Claude Code ( Issue #844) #1250 is primarily a CLI overhaul (18 files, 4000+ lines). This PR is focused purely on the MCP server + skill, making it lighter and more maintainable
• Uses real SDK API types (reward_amount not reward, correct endpoint paths)
• Only dependency: httpx (stdlib-only solution also possible)
• Proper JSON-RPC 2.0 error handling

Acceptance Criteria Met

• ✅ CLI commands for bounty CRUD operations
• ✅ Integration with SolFoundry API
• ✅ Support for batch bounty creation from config files
• ✅ Full SKILL.md for Claude Code integration

Testing

• MCP server starts correctly, registers all 12 tools
• JSON-RPC 2.0 stdio protocol implemented correctly
• Handles HTTP errors gracefully with structured error responses

Closes #844

[Ikalus1988]

Hi @mtarcure,

I'd like to briefly differentiate #1291 from #1250 for Bounty #844, since both PRs target the same bounty.

Complement, Not Compete

• feat: implement bounty CRUD, batch operations, and MCP server for Claude Code ( Issue #844) #1250 (Tusharkhadde): Full CLI CRUD + MCP server + dependency fixes — larger scope, good for developer UX
• feat(agents): SolFoundry Claude Code Skill — MCP Server + SKILL.md (Bounty #844) #1291 (Ikalus1988): Purpose-built SKILL.md + MCP server — designed specifically for Claude Code / AI Agent integration from day one

Why Keep Both?

The SKILL.md in #1291 is the Agent-facing contract — it defines how an AI agent discovers, registers, and uses the SolFoundry MCP tools. This is the layer that makes the MCP server usable by autonomous agents without human intervention.

Suggested merge path: Land #1250's CLI improvements + #1291's SKILL.md together — they solve different layers of the same problem.

Happy to coordinate or adjust scope if needed. Looking forward to your feedback!