MakerPerks MCP-AQL Adapter

A native MCP-AQL server over MakerPerks — the browseable, agent-friendly directory of builder perks (free credits, discounts, and programs for startups, students, OSS maintainers, indie devs, and non-profits).

It exposes the whole directory (200+ programs) to an AI agent through one token-cheap semantic tool (mcp_aql_read, ~120 tokens) instead of a wall of discrete MCP tools — the operations are discovered at runtime via introspection. That's ~95%+ fewer tool-registration tokens than a conventional "a tool per query" server.

Connect

• Hosted (zero install): add https://makerperks.mcpaql.com as a remote MCP connector (claude.ai, Claude Code, Cursor, …). OAuth registers automatically.
• Local (stdio): npm install && npm run build, then point your MCP client at node dist/index.js.

Then call mcp_aql_read with { "operation": "introspect" } to discover the operations: list_programs, get_program, search_programs.

How it works

• Native MCP-AQL READ surface over MakerPerks' published perks.json — decoupled from MakerPerks (no fork divergence; updates flow on refresh).
• stdio + Streamable HTTP transports over one transport-agnostic core.
• Hosted on Cloudflare Workers (web-standard Streamable HTTP), fronted by OAuth 2.1 + dynamic client registration so OAuth-mandatory clients connect. The endpoint is public and read-only.

Status

• Live: read adapter + dual transport + Cloudflare hosting + OAuth — done and archived (openspec/specs/).
• Next — Stage 1: an application pipeline that drives the actual perk signups under a user-controlled autonomy switch. Tracked as GitHub issues (epic #22).

Documentation

• CLAUDE.md — project configuration & conventions
• docs/ROADMAP.md — the staged plan
• docs/ARCHITECTURE.md — system model & MCP-AQL primitives
• openspec/specs/ — the spec baseline (capabilities)

License

Code & schemas: AGPL-3.0 (commercial tiers available, like the rest of the MCP-AQL org). Docs: CC BY 4.0.