README
¶
Examples
Example stacks demonstrating Gridctl patterns and capabilities.
🚀 Quick Start
gridctl deploy examples/getting-started/agent-basic.yaml
📁 Categories
| Folder | Description |
|---|---|
| 🎯 getting-started/ | Basic examples to get up and running |
| 🔌 transports/ | MCP transport types: local process, SSH, HTTP, SSE |
| 🤖 multi-agent/ | Agent orchestration and A2A protocol |
| 📦 platforms/ | Third-party MCP servers (container-based) |
| 🔗 openapi/ | Turn REST APIs into MCP tools via OpenAPI specs |
| 🔐 access-control/ | Tool filtering and security patterns |
| 🔒 gateways/ | Bridge to existing infrastructure |
| 📋 registry/ | Agent Skills registry (agentskills.io spec) |
| 🧪 _mock-servers/ | Test servers for development |
🎬 Recommended Path
- Start here:
getting-started/agent-basic.yaml- stack, networking, access control (placeholder containers) - Real MCP servers:
transports/local-mcp.yaml- actual MCP server logic via stdio transport - Multi-agent:
multi-agent/multi-agent-skills.yaml- agents using other agents as tools - Platforms:
platforms/github-mcp.yaml- third-party MCP servers - OpenAPI:
openapi/openapi-basic.yaml- turn any REST API into MCP tools - Registry:
registry/registry-basic.yaml- Agent Skills as MCP prompts
Note: Getting-started examples use placeholder containers to focus on infrastructure concepts. Transport and platform examples include real MCP server implementations.
📊 Feature Matrix
| Example | Transports | Agents | A2A | External | OpenAPI | Registry |
|---|---|---|---|---|---|---|
| agent-basic | - | ✅ | - | - | - | - |
| skills-basic | - | ✅ | ✅ | - | - | - |
| local-mcp | stdio | - | - | - | - | - |
| ssh-mcp | ssh+stdio | - | - | - | - | - |
| external-mcp | http, sse | - | - | ✅ | - | - |
| multi-agent-skills | - | ✅ | ✅ | - | - | - |
| basic-a2a | - | ✅ | ✅ | - | - | - |
| atlassian-mcp | sse | - | - | ✅ | - | - |
| chrome-devtools-mcp | stdio | - | - | ✅ | - | - |
| context7-mcp | stdio | - | - | ✅ | - | - |
| github-mcp | stdio | - | - | ✅ | - | - |
| zapier-mcp | stdio | - | - | ✅ | - | - |
| openapi-basic | openapi | - | - | - | ✅ | - |
| openapi-auth | openapi | - | - | - | ✅ | - |
| tool-filtering | - | ✅ | - | - | - | - |
| gateway-basic | http | - | - | ✅ | - | - |
| gateway-remote | http | - | - | ✅ | - | - |
| registry-basic | stdio | - | - | - | - | ✅ |
| registry-advanced | stdio | - | - | - | - | ✅ |
💻 Usage Pattern
All examples follow the same deployment pattern:
# Deploy a stack
gridctl deploy examples/<category>/<file>.yaml
# Force recreate containers
gridctl deploy examples/<category>/<file>.yaml
# View status
gridctl status
Directories
¶
| Path | Synopsis |
|---|---|
|
_mock-servers
|
|
|
local-stdio-server
command
Mock MCP Server for testing local process (stdio) MCP server support.
|
Mock MCP Server for testing local process (stdio) MCP server support. |
|
mock-mcp-server
command
Mock MCP Server for testing external HTTP/SSE MCP server support.
|
Mock MCP Server for testing external HTTP/SSE MCP server support. |
Click to show internal directories.
Click to hide internal directories.