llm-freewatch
Included among the curated providers whose free tiers are tracked (Cloudflare Workers AI), with each row carrying its source URL and human-verified date rather than being presented as live data.
Ships a human-verified curated entry for Cloudflare Workers AI's free tier, so agents can look up its free-model lineup, limits, and catches (with source URL and verification date) alongside the other providers.
Provides a curated, dated snapshot of Google Gemini's free tier — models, rate limits, and caveats such as training use — queryable via the free_providers tool.
Provides a curated, source-cited snapshot of the NVIDIA NIM free tier, letting agents check which NVIDIA-hosted models are free and their limits before wiring them into a project.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@llm-freewatch which free models can I use right now that support tool calling?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
llm-freewatch
Know which free LLM APIs still work today — before your agent finds out the hard way.
Free LLM tiers churn constantly: models appear and vanish, limits change without notice, and whole programs get retired (GitHub Models shut down on 2026-07-30 and old blog posts still recommend it). If your coding agent, side project, or demo is wired to a hard-coded "free" model id, it breaks silently.
llm-freewatch is a zero-dependency Python tool that keeps an eye on the free
landscape for you:
Live radar — fetches the live OpenRouter catalog and lists models that are actually free right now (prompt and completion price both $0), with context length and tool-calling support.
Change diffs — every scan is diffed against the previous one, so you see which free models were added or removed since yesterday.
Fallback chains — prints an ordered chain of free, tool-calling models (JSON, or a ready-to-use LiteLLM config) to walk when one model returns 429/404.
Real probes — optionally runs one genuine tool-call against a model with your own key and classifies the result
ok/hard/transient. A 429 is reported as transient — not a verdict, never as "the model is broken".Curated providers — for providers without a public catalog API (Groq, Google Gemini, NVIDIA NIM, Mistral, Cloudflare Workers AI, Cohere), ships a curated table where every row carries its source URL and human-verified date, including the catches (card rules, training use, trial-only). Curated rows are never disguised as live data.
MCP server — runs over stdio, so Claude Code / Codex / Cursor agents can ask mid-task: "which free models can I use right now?" instead of guessing.
Agent skill — ships a
SKILL.md(seeskill/) that teaches agents when and how to check the free lineup before hard-coding a model.
Zero third-party dependencies. Python 3.10+ standard library only.
Quick start
git clone <this repo>
cd llm-freewatch
python3 -m llm_freewatch scan --tools # what is free + tool-capable right now
python3 -m llm_freewatch providers # curated free tiers, limits and catches
python3 -m llm_freewatch chain # ordered fallback chain (JSON)
python3 -m llm_freewatch chain --format litellm > litellm_config.yamlExample output (live, 2026-10-22):
MODEL CONTEXT TOOLS
thinkingmachines/inkling:free 1,048,576 yes
nvidia/nemotron-3-ultra-550b-a55b:free 1,000,000 yes
google/gemma-4-31b-it:free 262,144 yes
...
18 free models.The current snapshot is regenerated daily in docs/FREE_MODELS.md.
Related MCP server: FreeLLM-MCP
Probe a model for real (optional)
export OPENROUTER_API_KEY=... # your own key; read from env only, never stored
python3 -m llm_freewatch probe nvidia/nemotron-3-super-120b-a12b:free
# {"model": "...", "verdict": "ok", "http": 200, "latency_ms": 812}Use it as an MCP server
{
"mcpServers": {
"llm-freewatch": {
"command": "python3",
"args": ["-m", "llm_freewatch", "mcp"],
"cwd": "/path/to/llm-freewatch"
}
}
}Tools: list_free_models, free_model_changes, free_providers.
Why this exists
This project grew out of running a personal coding agent on free models: the free lineup rotated often enough that a daily radar + diff became the difference between "agent works" and "agent silently fails". The same churn is documented publicly — free-tier roundups in October 2026 all warn that the limits and lineups they list will be wrong soon. A list goes stale; a watcher doesn't.
Honest limits
Only the OpenRouter catalog is fetched live today. Other providers are curated snapshots with sources and dates, and they will drift — PRs updating a row must update its
verifieddate and source."Free" means the provider lists $0 pricing. Free tiers have rate limits (for OpenRouter free models, typically 20 RPM and 50 requests/day on a free account) and providers may log or train on free-tier prompts. Check each provider's terms.
A probe
okmeans one tool call worked once. It is a smoke test, not a benchmark.
Development
python3 -m pytest tests/ -q # or run the test modules with any runnerLicense
MIT
中文说明见 README.zh-CN.md。
Available Tools
3 toolsfree_model_changesA
Diff the live free catalog against the last local scan: which free models appeared or disappeared. Free lineups rotate; check before hard-coding a model id.
Inputs: no named parameters.
free_providersA
Curated, human-verified free tiers for providers without a public catalog API (Groq, Gemini, NVIDIA NIM, Mistral, Cloudflare, Cohere), with limits, card rules and catches, each with source and verified date.
Inputs: no named parameters.
list_free_modelsC
List currently free models from the live OpenRouter catalog. Optionally require tool calling and a minimum context length.
Inputs: limit, tools_only, min_context.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct concern: live catalog listing, a delta against the previous scan, and curated static provider info. The only mild overlap is between list_free_models and free_model_changes, since the diff presumably builds on the same catalog, but descriptions make the boundary clear.
list_free_models follows a verb_noun pattern while free_model_changes and free_providers are bare noun phrases, so the convention is mixed. Names remain short and readable, and the shared 'free' prefix gives topical coherence.
Three tools is lean but each covers a genuinely different access mode (live query, historical diff, curated reference). The scope is narrow enough that this isn't bloated, though it sits at the thin end of the range.
The surface has a notable gap: free_model_changes diffs against 'the last local scan' but there is no tool to perform or update a scan/baseline, so the diff can be a dead end. There is also no lookup for a single model's details or pricing limits beyond raw listing.
Maintenance
Related MCP Connectors
Live registry of AI model specs, context windows, and per-token pricing.
Read-only lookups of public AI agent pricing, free plans and source links. No API key.
Agent-operated. Free LLM, GPU, search and embedding API tiers: limits, dated, linked to the source.
Verified free AI offers, free LLM APIs, models, best lists, deadlines and cost calc from aifree.dev.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceDiscovers LLM models in real time from cloud providers and local Ollama instances, returning compatibility profiles and live pricing so AI agents can route tasks to the cheapest viable model without breaking tool calls or context clipping.9MIT

FreeLLM-MCPofficial
AlicenseAqualityBmaintenanceEnables AI coding assistants and agent workflows to query live measured free-LLM performance and availability, including throughput, uptime, tool-calling success, and model diagnostics.42MIT- AlicenseNot gradedqualityCmaintenanceEnables AI agents to browse, inspect, and compare LLMs from OpenRouter's catalog with normalized per-million-token pricing, context windows, and modalities. Supports filtering by search, free-only status, minimum context, or modality.442 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to see which model IDs each provider's API has started listing since the last check, and to list the models a given provider currently serves with optional substring filtering, all without spending tokens.MIT