@aifree/mcp

MCP server for aifree.dev: the verified directory of free AI offers (free tiers, API credits, student and startup programs). Ask your agent "what free TTS has no card?", "compare Groq and Gemini free tiers", "what changed this week?" and it cites the verified offer pages.

Tools: search_free_ai_offers, get_offer, list_free_llm_apis, find_models, recent_changes, compare_offers, check_eligibility, ask_aifree. check_eligibility { student?, startupStage?, country?, noCard?, building?, limit? } answers "I am a student in Vietnam with no card, what free AI can I claim?" with the /unlock quiz rules: verified offers first, the verified USD total (USD rows only) and a link to the same result as a page. get_offer includes the offer's models[] with each model's published free-tier rateLimit (rpm, rpd, tpm, optional tpd, rpmo; null = not published); find_models { query?, family?, toolCalling?, vision?, noCard?, limit? } answers "which free API serves gpt-oss-120b and at what RPM?" with one row per (offer, model), ranked like the free LLM API picker. The tool list comes from the hosted server, so this proxy picks up new tools without an update. Resources: aifree://llms.txt, aifree://hubs, aifree://hubs/{slug}, aifree://changes. Data is CC BY 4.0; only rows marked verified were tested by a person.

Hosted endpoint (no install)

https://aifree.dev/mcp speaks Streamable HTTP, stateless, no auth.

• Claude Code: claude mcp add --transport http aifree https://aifree.dev/mcp
• Cursor (.cursor/mcp.json): { "mcpServers": { "aifree": { "url": "https://aifree.dev/mcp" } } }
• Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → URL https://aifree.dev/mcp

This package (stdio proxy)

Not published on npm yet: npx -y @aifree/mcp does not work today. Use the hosted endpoint above; for clients that only run local stdio servers, run the proxy from a checkout of the source (Node 18+, no dependencies):

{
  "mcpServers": {
    "aifree": {
      "command": "node",
      "args": ["/path/to/aifree.dev/packages/mcp/index.mjs"]
    }
  }
}

Once the package is published, the config becomes { "command": "npx", "args": ["-y", "@aifree/mcp"] }.

Set AIFREE_MCP_URL to point at another endpoint (for example a preview deploy). Nothing is stored locally; every call is forwarded.

Source: packages/mcp in the aifree.dev repository (private for now).