Install Seenode into Cursor, Claude Code, and OpenAI (ChatGPT / Codex) so agents can deploy and operate apps on Seenode through the hosted MCP at https://mcp.seenode.com/mcp.
This repository is a portable Agent Plugin: shared skills plus thin client adapters. The MCP server implementation is proprietary platform software and is not included here. Authentication is OAuth — no API keys or bearer tokens belong in plugin config.
Use this plugin when you want an AI coding agent to:
- Deploy a GitHub or GitLab repo to Seenode as a web, worker, or private app
- Create and link managed MySQL/PostgreSQL databases (without pasting passwords)
- Debug failed builds and runtime crashes with logs, metrics, wait/cancel helpers
- Manage environment variables, custom domains, projects, storage volumes, and billing/credits
Agent client (Cursor / Claude Code / Codex)
└── Seenode Agent Plugin (this repo)
├── skills/ shared workflow instructions
└── mcp config → https://mcp.seenode.com/mcp (OAuth)
└── Seenode platform API
| Client | Guide |
|---|---|
| Cursor | docs/cursor.md |
| Claude Code | docs/claude.md |
| OpenAI ChatGPT / Codex | docs/openai.md |
Overview: docs/installation.md. Marketplace publishing: docs/publishing.md.
After install, complete Seenode OAuth when prompted, then try a read-only smoke prompt such as “What is my current Seenode team?”
- “Deploy this repository to Seenode as a web app.”
- “Create a PostgreSQL database, wait until it’s ready, and link it to my app.”
- “Why did my latest Seenode deployment fail? Wait for the next deploy after you fix it.”
- “What’s my Seenode credit balance in USD?”
- “List my Seenode applications and their deploy status.”
- “Add
example.comto my Seenode web app and show the DNS records.”
| Skill | Purpose |
|---|---|
deploy |
End-to-end deploy: DB → inspect → app → link → wait |
troubleshoot |
Failed deploys and apps that won’t start |
applications |
Discover and manage web/worker/private apps |
environment |
Env vars and secrets (prefer DB link over paste) |
databases |
Create, update, rotate, and link managed DBs |
storage |
Persistent application volumes |
domains |
Custom domains and DNS verification |
projects |
Team context, limits, and project grouping |
billing |
Credits, usage, portal, and top-ups |
- No delete/destroy tools for apps, databases, domains, projects, or storage (only
delete_environment_variables) - No static-site / cron / blueprint / key-value product types on this MCP surface
- Never fetch or echo raw DB passwords — use
link_database_to_application
- OAuth-only MCP config (no static secrets in manifests)
- Skills instruct agents not to echo secret env values or DB passwords
- Vulnerability reports: see SECURITY.md → help@seenode.com
./scripts/validate.shSee docs/development.md and CONTRIBUTING.md.
MIT © Seenode
