Welcome to a new paradigm in AI development. MCP provides the foundation for building intelligent, interoperable agents that can communicate, evolve, and generate value at the edge of the network.
We're extending Cloudflare's vision for AI Agents with a focus on web3 and MCPs as plugins:
- 🤝 AI Agents as teammates/organizations generating revenue and performing advanced operations
- 💰 Cost-effective shared hosting options
- 🔒 Secure sensitive assets (trading agents, treasuries, etc.)
- 📈 Self-improving agents based on collective usage
- 💸 Drive MCP usage revenue to open source contributors
- 💼 Monetization avenues for closed-source MCP use cases
- ⚙️ Seamless configuration options
- 🚀 Quick iteration on ideas locally and in-cloud
- 🔓 No vendor lock-in, self-hosting and personal account options
This project is in pre-alpha and actively evolving. Current focus areas:
- ✅ Core MCP Framework
- ✅ Multi Session & Authentication Patterns
- ✅ Official MCP WebSocket Support and HTTP Streaming Support
- ✅ Agent Framework (AI SDK)
- ✅ Seamless MCP Plugins (mcp.json) for Agents
- ✅ Agent MCP Dependency Management
- ✅ MCP Webhook / External Service Support
- ✅ Playground UI for LLMs + MCPs
- ☁️ Cloudflare Service Examples (KV, D1, DO state, Analytics, Workflows, Schema Migrations)
- 🤖 LangChain and Agent SDK examples coming soon
- 📄 Cloudflare Pages (SSE / Fullstack) Examples
- 🔑 Authentication (OAuth, JWT)
Get started with the Null Shot CLI to create MCP servers and AI agents:
npm install -g @nullshot/clinullshot create mcpnullshot create agentnullshot initnullshot installnullshot devThis framework supports 6 major AI providers with dynamic model fetching and official SDK integration:
| Provider | Latest Models | SDK | Dynamic | API Key |
|---|---|---|---|---|
| OpenAI | GPT-4o, GPT-4o-mini, GPT-3.5-turbo | @ai-sdk/openai |
✅ | ✅ |
| Anthropic | Claude Opus 4.1, Claude Sonnet 4, Claude 3.7 | @ai-sdk/anthropic |
✅ | ✅ |
| DeepSeek | DeepSeek-Chat, DeepSeek-Coder | @ai-sdk/deepseek |
✅ | ✅ |
| Workers AI | Llama 3.1/3.2, Gemma 2, Mistral 7B (~49 models) | workers-ai-provider |
✅ | Cloudflare |
| Gemini | Gemini 1.5 Pro Latest, Gemini 1.5 Flash Latest | @ai-sdk/google |
✅ | ✅ |
| Grok | Grok-4, Grok-3, Grok-3-mini, Grok-2-1212 | @ai-sdk/xai |
✅ | ✅ |
- 🔄 Dynamic Model Fetching: Real-time model lists from provider APIs with intelligent fallbacks
- 🎯 Official SDK Integration: Uses official AI SDK providers for consistent, reliable integration
- 💾 Smart Caching: Model lists cached for 30 minutes with API key validation
- 🔧 Provider-Aware UI: Auto-loading saved API keys and intelligent model selection
- 📡 Streaming Support: Real-time responses across all providers
- ⚡ Fallback Handling: Graceful degradation when APIs are unavailable
- Next.js Web App:
examples/playground-showcase- Full-featured chat interface - Cloudflare Workers Agent:
examples/simple-prompt-agent- Server-side AI agent - React Components:
packages/playground- Reusable UI components
Comprehensive documentation is available at Null Shot Docs:
- Project Overview - Get started with Null Shot
- Agent Framework - Getting Started - Build AI agents with Cloudflare Workers
- MCP Framework Overview - Model Context Protocol implementation
- Platform Overview - Understanding the platform architecture
- Common Services - Cloudflare services integration
- Playground - Interactive development environment
This repository uses an automated release workflow following semantic versioning:
- Pull Request Testing - When you create a PR, it automatically runs tests and a semantic-release dry run
- Automated Publishing - When merged to main, changed packages are automatically published to npm
- Versioning - Package versions are determined by Conventional Commits standards
For detailed information about our release process, see .github/RELEASE_PROCESS.md.
We welcome contributions! Our vision is to create a collaborative ecosystem where AI and human developers work together. Soon, we'll have an AI agent to audit and govern contributions based on our shared vision.
If you're interested in contributing, please:
- Join our Discord community
- Watch this repository for updates
- Star the project if you find it interesting
MIT License - see the LICENSE file for details.