Minimal MCP server for AI agent integration

[jeremy]

Use Fizzy from your favorite LLM. Even use Fizzy as a coordination bus for your agents, workflows, and skills. Fluent, fast, no bloat.

This is a simple, purposefully bare-bones trial-balloon implementation with no new abstractions or modeling. (Rails' take on MCP should elegantly satisfy what we're after here, but this isn't the PR for it.)

Model Context Protocol 2025-06-18 with streamable HTTP. Resource responses are concise to limit token bloat and keep context window creep under control.

Endpoints:

• GET /.well-known/mcp.json - Discovery with OAuth server reference
• POST /mcp - JSON-RPC requests with bearer token authentication

Tools (create_board, create_card, update_card, move_card) for workspace management. Resources for reading accounts, boards, and cards via fizzy:// URI scheme.

Builds on OAuth 2.1 support for seamless authentication: #2296

> Give the Fizzy MCP a spin and show it off a little. 

⏺ fizzy-dev - create_board (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", name: "Claude Code Integration", columns:
                                ["Backlog","Up Next","In Progress","Done"])
  ⎿  {                                                                                                             
       "id": "03fcova6uufz7y62j61w6h182",
       "name": "Claude Code Integration",
     … +8 lines (ctrl+o to expand)

⏺ fizzy-dev - create_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", board: "Claude Code Integration", title: "OAuth
                               2.1 with PKCE", description: "Dynamic client registration, authorization code flow, token
                                exchange")
  ⎿  {                                                                                                             
       "number": 17,
       "title": "OAuth 2.1 with PKCE",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - create_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", board: "Claude Code Integration", title: "MCP HTTP
                                transport", description: "JSON-RPC 2.0 over Streamable HTTP with bearer token auth")
  ⎿  {                                                                                                             
       "number": 18,
       "title": "MCP HTTP transport",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - create_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", board: "Claude Code Integration", title: "Tools
                               and Resources", description: "create_board, create_card, update_card, move_card +
                               fizzy:// resources")
  ⎿  {                                                                                                             
       "number": 19,
       "title": "Tools and Resources",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - create_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", board: "Claude Code Integration", title:
                               "Production deployment")
  ⎿  {                                                                                                             
       "number": 20,
       "title": "Production deployment",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - move_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", card: "17", to: "done")
  ⎿  {                                                                                                             
       "number": 17,
       "title": "OAuth 2.1 with PKCE",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - move_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", card: "18", to: "done")
  ⎿  {                                                                                                             
       "number": 18,
       "title": "MCP HTTP transport",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - move_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", card: "19", to: "done")
  ⎿  {                                                                                                             
       "number": 19,
       "title": "Tools and Resources",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - update_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", card: "19", comment: "Shipped! 🚢 This card was
                               created, moved, and commented on entirely via MCP.")
  ⎿  {                                                                                                             
       "number": 19,
       "title": "Tools and Resources",
     … +4 lines (ctrl+o to expand)

⏺ fizzy-dev - move_card (MCP)(account: "03f6treajp9yfa7z2cdgufkf9", card: "20", to: "Up Next")
  ⎿  {                                                                                                             
       "number": 20,
       "title": "Production deployment",
     … +4 lines (ctrl+o to expand)

⏺ readMcpResource(Read resource "fizzy://accounts/03f6treajp9yfa7z2cdgufkf9/boards/03fcova6uufz7y62j61w6h182" from
                 server "fizzy-dev")
  ⎿  {                             
       "contents": [
         {
     … +14 lines (ctrl+o to expand)

⏺ Claude Code Integration board:

  | Backlog | Up Next                   | In Progress | Done                    |
  |---------|---------------------------|-------------|-------------------------|
  |         | #20 Production deployment |             | #17 OAuth 2.1 with PKCE |
  |         |                           |             | #18 MCP HTTP transport  |
  |         |                           |             | #19 Tools and Resources |

  Three shipped, one queued up. All managed from here via MCP.