Skytells MCP
Connect Claude Code, Gemini CLI, VS Code, Cursor, and other MCP clients to Skytells for model discovery, predictions, and full CLI coverage.
The Skytells MCP (Model Context Protocol) server connects MCP-compatible clients — Claude Code, Gemini CLI, VS Code with GitHub Copilot, Cursor, and OpenAI Codex CLI — to the Skytells CLI, public model discovery, generated media downloads, and Skytells Learn search.
It ships in two forms:
- A hosted server at
https://mcp.skytells.aifor public model discovery and Learn search, with no authentication required. - A local server, run via
npx -y @skytells/mcp, that additionally exposes your CLI session — projects, apps, deployments, predictions, Orchestrator, Cloud Agents, Cognition, and more.
Hosted Server
Connect to https://mcp.skytells.ai for public model discovery — no install or credentials needed.
Local Installation
Run the MCP locally with npx -y @skytells/mcp for full CLI coverage and authenticated tools.
Authentication
How the three Skytells credentials map to MCP tools, and why the MCP never returns their values.
Tools Reference
Every public and local tool exposed by the MCP, including skytells_run and prediction helpers.
Get started
- Create a Skytells account.
- Open the Skytells Console to manage projects and API keys.
- Browse Skytells Learn for guides and tutorials.
- Read the Skytells API documentation.
Which server should I use?
| Hosted server | Local server | |
|---|---|---|
| Endpoint | https://mcp.skytells.ai | npx -y @skytells/mcp (stdio) |
| Setup | Add a URL to your client config | Requires Node.js 20+ |
| Authentication | None | Uses your CLI credentials |
| Model discovery | ✅ list_models, search_models, get_model | ✅ Same, plus everything below |
| Skytells Learn search | ✅ | ✅ |
| Projects, apps, deployments | ❌ | ✅ |
| Predictions (create/get/list/cancel/delete) | ❌ | ✅ |
Full CLI coverage via skytells_run | ❌ | ✅ |
The GitHub repository for the CLI and MCP can remain private — npx downloads the published npm packages directly.
Related
- Skytells CLI — the command-line interface the local MCP wraps.
- CLI: Predictions — the underlying commands behind the MCP's prediction tools.
- API keys — manage the credentials referenced in Authentication.
How is this guide?