MCP Free-Pool Worker
Uses GitHub Models as a provider in the free/local pool, allowing delegated tasks to be fulfilled by GitHub-hosted models when configured.
Delegates coding/text tasks to Google AI Studio Gemini models as part of the provider pool, with failover and cooldown handling.
Provides a local LLM provider via LM Studio at localhost:1234 for delegated coding tasks, including handling when the local server is not running.
Mentioned as a local model server option for the Local provider; local delegated tasks report network errors when LM Studio/Ollama is not running.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Free-Pool Worker
Servidor MCP (stdio) que delega tarefas mecânicas de código a um pool de provedores gratuitos/locais, com failover por modelo, cooldown por cota e validação antes de gravar arquivos.
Requisitos
Node.js >= 22
Pelo menos uma chave de provedor (Groq, Google AI Studio ou OpenRouter já verificados)
Related MCP server: io.github.sidduHERE/agentpool
Instalação
git clone https://github.com/LucasMGamerPlay/mcp-free-pool-worker.git
cd mcp-free-pool-worker
npm ci
npm run build
Copy-Item .env.example .env # preencha as chaves que você tem
npm test # 51 testes, inclui um E2E com provedor mockadoProvedores sem chave são ignorados (no-key no relatório) e o pool segue para o próximo.
Registrar no cliente
Os arquivos em examples/ estão prontos para copiar — troque o caminho do dist/src/index.js e o WORKSPACE_ROOT:
Cliente | Arquivo | Destino |
OpenCode |
|
|
Claude Code |
|
|
Codex CLI |
|
|
As chaves vêm do .env da pasta deste projeto; variáveis definidas no env do cliente têm precedência. O WORKSPACE_ROOT é a raiz usada para resolver context_files e output_file_path — se omitido, vale o diretório atual do cliente.
No OpenCode a forma atual é mcp.servers.<nome> (a forma antiga, com o servidor direto dentro de mcp, está marcada como deprecated no schema). Nela não existe enabled: use disabled: false se quiser declarar explicitamente que o servidor está ativo.
Instalar a skill do modelo gerente
New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode\skills\free-pool-worker"
Copy-Item skills/SKILL.md "$env:USERPROFILE\.config\opencode\skills\free-pool-worker\SKILL.md"O nome da pasta precisa ser igual ao name: do frontmatter (free-pool-worker), senão a skill não é descoberta. Para Claude Code, o destino é ~/.claude/skills/free-pool-worker/SKILL.md.
Verificar que está no ar
Peça ao modelo gerente: "chame worker_pool_status". Você deve ver cada provedor com state, keys_available e a lista de models com o respectivo estado — além de workspace_root, config_file e state_file, que respondem "qual raiz, qual config e onde ficam os cooldowns". Para um teste ponta a ponta, use delegate_task com task_type: coding e "Reply with exactly: PONG".
Provedores
Provedor | Modelos | Status |
Groq |
| verificados |
Google AI Studio |
| verificados |
OpenRouter |
| verificados (429 intermitente no tier free) |
Cerebras |
| não verificados (sem chave) |
GitHub Models |
| não verificados (sem chave) |
Local |
| não verificado (LM Studio em |
Modelos gratuitos mudam com frequência: confira o catálogo do provedor e edite config/providers.json — não é necessário recompilar.
O que é validado antes de gravar
Extensão | Validação |
| parser do TypeScript ( |
|
|
| parser |
| AST do CPython ( |
demais | nada; a resposta diz |
A checagem é de sintaxe. Regra de negócio continua sendo responsabilidade do build/lint/teste do seu projeto.
Problemas comuns
Sintoma | Causa | Ação |
| variável ausente no | preencher e reiniciar o servidor |
| cota/rate limit do modelo | esperar; o cooldown fica salvo em |
| a saída estourou | aumentar o parâmetro (máx. 16000) |
| saída não passou na validação de sintaxe | o pool já tentou os outros modelos; corrigir a instrução |
| LM Studio/Ollama não está rodando | subir o servidor local ou remover o provedor |
Licença
MIT — veja LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Command center for developers coordinating AI coding agents across projects.
The team layer for AI coding agents: shared contracts, collision alerts, E2EE sessions.
Multiplayer for the coding agents your team already uses: shared tasks, decisions, skills and tools.
Coding agents from Claude Code, Cursor and Codex claim jobs and lock files on one shared board.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI to delegate boilerplate, drafts, tests, and refactors to free LLM providers, saving tokens and running tasks in parallel.357 npmMIT
- AlicenseNot gradedqualityCmaintenanceAgentPool is a local MCP server that monitors live usage limits of coding-agent subscriptions and allows you to offload work to providers with remaining capacity. It exposes provider, model, and session state, enabling informed manual or agent-driven task delegation.1MIT
- FlicenseNot gradedqualityAmaintenanceEnables coding agents and OpenAI- or Anthropic-compatible clients to send chat requests through a single local pooled endpoint that spans free provider tiers, with keyless startup, automatic failover, model discovery, and capacity/health inspection tools.-
- FlicenseNot gradedqualityAmaintenancePools enabled free-tier, keyless, and trial LLM chat routes behind a single OpenAI-compatible endpoint with automatic failover and local usage tracking, so coding agents and OpenAI/Anthropic-compatible tools can run on free models without changing their code. It also exposes provider health, capacity, model inventory, and routing-mode tooling so clients can discover and use whichever chat routes are currently accessible, including some that require no API key.-