AI Model Registry MCP Server
Enables Hermes agents to query a live AI model registry for up-to-date model information, including listing, searching, and retrieving best models for various capabilities.
Click on "Install 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., "@AI Model Registry MCP Serverlist the best models for vision tasks"
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.
AI Model Registry
Live AI model registry that polls OpenRouter, HuggingFace, and Ollama Cloud hourly. Provides agents (Hermes, OpenClaw, Claude Code) with up-to-date model information so they never recommend outdated models from stale training data.
Architecture
┌─────────────────────────────────────────────┐
│ AI Model Registry (FastAPI) │
│ │
│ ┌─────────┐ ┌──────────┐ ┌─────────────┐ │
│ │OpenRouter│ │HuggingFace│ │Ollama Cloud │ │
│ │ poller │ │ poller │ │ poller │ │
│ └────┬─────┘ └─────┬─────┘ └──────┬──────┘ │
│ └──────────────┼────────────────┘ │
│ ▼ │
│ In-Memory Cache │
│ │ │
│ ┌────────────┼────────────┐ │
│ ▼ ▼ ▼ │
│ REST API MCP Server Hermes Skill │
│ (port 8000) (stdio) (SKILL.md) │
└─────────────────────────────────────────────┘Related MCP server: ai-model-selector-mcp
Quick Start
# Clone
git clone <your-repo> ai-model-registry
cd ai-model-registry
# Install
pip install -r requirements.txt
# Run the API server
python -m uvicorn src.server:app --port 8000
# In another terminal, test it
curl http://localhost:8000/
curl http://localhost:8000/models/best?capability=coding
curl http://localhost:8000/models/search?q=kimiDeploy on VPS (systemd)
# Copy to VPS
scp -r ai-model-registry user@vps:/opt/ai-model-registry
# Install deps
cd /opt/ai-model-registry
pip install -r requirements.txt
# Install service
sudo cp deploy/ai-model-registry.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now ai-model-registry
# Verify
curl http://localhost:8000/MCP Integration (Hermes)
Add to ~/.hermes/config.yaml:
mcp_servers:
model_registry:
command: "python3"
args: ["/opt/ai-model-registry/src/mcp_server.py"]
env:
REGISTRY_API_URL: "http://localhost:8000"Then copy the skill:
cp -r skill /path/to/.hermes/skills/ai-model-registryRestart Hermes. Tools will appear as:
mcp_model_registry_list_modelsmcp_model_registry_search_modelsmcp_model_registry_best_modelsmcp_model_registry_registry_stats
API Endpoints
Endpoint | Description |
| Health check + cache info |
| List models with filters (source, capability, min_context, max_input_price, limit, offset) |
| Search by name/id/description |
| Best models for a capability (coding, vision, tools, reasoning, agent, general, cheapest, largest_context) |
| Filter by provider |
| Manual refresh |
| Registry statistics |
Environment Variables
Var | Default | Description |
|
| Seconds between polls (1 hour) |
| (empty) | Ollama Cloud API key for full model listing |
|
| URL for MCP server to connect to |
Data Sources
OpenRouter:
GET https://openrouter.ai/api/v1/models— 400+ models with pricingHuggingFace:
GET https://huggingface.co/api/models— Hub models + inference modelsOllama Cloud:
GET https://ollama.com/api/tags— Cloud models (API key optional)
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/adamchall87/ai-model-registry'
If you have feedback or need assistance with the MCP directory API, please join our Discord server