Log inSubmit server
Freellmpool logo

Freellmpool

Pool accessible free-tier and keyless LLM routes behind MCP tools for querying, routing, model discovery, quotas, and usage stats.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Freellmpool

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "freellmpool": {
      "command": "uvx",
      "args": [
        "freellmpool"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

uvx freellmpool

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 16d ago.

Overview

freellmpool MCP server exposes pooled access to enabled LLM routes from a catalog of providers. Its MCP tools support asking models, comparing responses with panels, selecting routes, listing models, checking quotas, and viewing statistics. It automatically uses accessible routes and can fail over when a route is unavailable or rate limited. Reach for it when an agent needs one interface for multiple free-tier, keyless, or configured provider endpoints.

Use cases

  • Ask pooled free-tier models from an MCP-compatible agent
  • Compare responses across multiple accessible LLM routes
  • Inspect available models and provider capacity
  • Route requests around unavailable or rate-limited providers
  • Monitor local quotas and usage statistics

Key features

  • Multi-provider LLM route pooling
  • MCP tools for asking and comparing models
  • Route selection and automatic failover
  • Model, quota, and statistics inspection
  • Keyless startup when an eligible route is available
  • OpenAI-compatible local proxy

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

26/29 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · freellmpool (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars147Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Freellmpool works

What freellmpool MCP server does

freellmpool MCP server gives MCP-compatible agents access to a pool of enabled chat routes from multiple LLM providers. The project catalogs providers across recurring free tiers, keyless endpoints, finite trials, pin-only routes, and disabled candidates, but automatic routing uses only routes that are enabled and accessible in the local configuration.

The server exposes tools for sending prompts, comparing model responses, inspecting available models, choosing routes, checking quota information, and reviewing usage statistics. The repository describes these capabilities as ask, panel, tokenmax, route, models, quota, and stats. The exact providers available to an installation depend on provider status, credentials, rate limits, and local usage.

How it works

Install the Python package and start its MCP mode with freellmpool mcp. The application maintains a provider catalog and selects from usable routes behind the pool. When a route is down or rate limited, freellmpool can fail over to another eligible route. It also tracks local per-day usage.

The broader freellmpool package can operate without credentials when an enabled keyless provider is available. Providers named in the documentation as potentially keyless include Pollinations, OVHcloud, Kilo Gateway, and LLM7. Adding provider keys can unlock additional models and higher limits, but eligibility and limits remain provider-specific.

In addition to MCP, the package provides a command-line interface, Python library, and local OpenAI-compatible proxy. The proxy can be used by existing OpenAI-compatible applications, while an experimental Anthropic-compatible path supports text-only requests. These interfaces are separate from the MCP tool surface but can be useful when an agent or application needs an API endpoint instead of MCP calls.

Setup and configuration

Install Python 3.11 or later with one of the supported package commands:

Terminal
pip install freellmpool
# or
uvx freellmpool

Start the MCP server with:

bash
freellmpool mcp

Run freellmpool init --yes to inspect locally available provider keys, installed agent CLIs, proxy configuration, and Tailscale state. The command prints a suggested next step and does not edit files. Its --json option emits the detection results as versioned JSON for scripts and agents.

The package can start without credentials if a usable keyless route is available. Otherwise, configure provider credentials according to the providers you intend to use.

Tools and capabilities

  • Ask an available model through the pooled provider catalog.
  • Send a prompt to multiple routes with the panel capability.
  • Select or inspect routing behavior with route-related operations.
  • List cataloged models and available provider routes.
  • Check provider quota and local usage information.
  • Inspect runtime statistics.
  • Use tokenmax to examine token-related model or route results.

Limitations and notes

The catalog contains more entries than the automatically usable pool; disabled, inaccessible, rate-limited, or credential-gated routes are not necessarily available for a request. Provider terms, quotas, and availability differ, and the project records local daily usage rather than removing those external limits.

The README identifies the MCP mode but does not document a complete MCP tool schema, transport matrix, or per-tool argument reference. Local runtimes such as LM Studio, Ollama, and llama.cpp are handled separately through explicit loopback discovery and import commands, and imported local models are excluded from automatic routing.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Freellmpool

freellmpool is an MCP server that connects agents to accessible LLM provider routes through one pooled interface. Its main tools let agents ask models, compare responses with panels, select routes, list models, inspect token limits, check quotas, and view usage statistics. It can use keyless routes when one is enabled and available.

Install it with `pip install freellmpool` or run it through `uvx freellmpool`. Python 3.11 or newer is required. After installation, start MCP mode with `freellmpool mcp`.

Yes, freellmpool can run without API keys when an enabled keyless provider route is available. The README names Pollinations, OVHcloud, Kilo Gateway, and LLM7 as providers that may work without a key. Availability, quotas, and route eligibility can change.

Yes, Cursor is named among the agent integrations supported by the broader freellmpool project. The MCP server itself is intended for MCP-compatible clients, while the project also provides an OpenAI-compatible proxy that applications can point to through `OPENAI_BASE_URL`.

Related MCP servers

All in Conversational AI All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFreellmpool AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/freellmpool?style=directory)](https://allmcps.com/mcp/freellmpool)
HTML Embed
<a href="https://allmcps.com/mcp/freellmpool"><img src="https://allmcps.com/api/badge/freellmpool?style=directory" alt="Freellmpool on AllMCPs" /></a>