InstaPods
Deploy and manage web apps on InstaPods: create pods, push files, run commands, read logs.
Open source Repository Open in the app JSON README (API)
About
Deploy and manage web apps on InstaPods: create pods, push files, run commands, read logs.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- com.instapods
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.0
- Last push
- 2026-09-06T08:00:18Z
- Repository state
- ativo
- Added
- 2026-08-29 03:01:11
- Updated
- 2026-08-29 03:01:11
- Origin id
com.instapods/instapods
README
# InstaPods SDK
Tools and integrations for deploying and managing apps on [InstaPods](https://instapods.com) with AI assistants.
InstaPods is container hosting for developers — deploy Node.js, Python, PHP, and static apps with a single command. This SDK provides two ways to integrate InstaPods with Claude:
## Integration Paths
### Claude Code (CLI Skill)
A skill that teaches Claude Code how to deploy and debug apps using the `instapods` CLI.
**Setup:**
1. Install the CLI:
```bash
curl -fsSL https://instapods.com/install.sh | sh
instapods auth login
```
2. Copy the skill to your project:
```bash
mkdir -p .claude/skills/instapods-cli
curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-cli/SKILL.md \
-o .claude/skills/instapods-cli/SKILL.md
```
3. Ask Claude Code to deploy:
```
> deploy my app to instapods
> my app is returning 502, help me debug
> add a PostgreSQL database to my pod
```
### Claude Desktop / Claude.ai (MCP Skill)
Two options — use the MCP skill for guided workflows, or connect directly via MCP.
**Option A: MCP Skill (recommended)**
Copy the skill to your project:
```bash
mkdir -p .claude/skills/instapods-mcp
curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-mcp/SKILL.md \
-o .claude/skills/instapods-mcp/SKILL.md
```
**Option B: Direct MCP connection**
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"instapods": {
"url": "https://app.instapods.com/api/mcp"
}
}
}
```
On first use, Claude will walk you through OAuth authentication. See [mcp/README.md](mcp/README.md) for the full setup guide.
The MCP server includes built-in prompts:
- **deploy-app** — Guided deployment workflow
- **debug-pod** — Systematic pod diagnosis
- **getting-started** — Overview of available tools and resources
## What's in This Repo
```
sdk/
├── README.md # This file
├── server.json # MCP Registry manifest (see below)
├── skills/
│ ├── instapods-cli/
│ │ └── SKILL.md # Skill for Claude Code (uses CLI)
│ └── instapods-mcp/
│ └── SKILL.md # Skill for Claude Desktop/Claude.ai (uses MCP tools)
├── mcp/
│ └── README.md # MCP server setup guide
└── cli/
└── README.md # CLI quick reference
```
## MCP Registry
InstaPods is listed in the official [MCP Registry](https://registry.modelcontextprotocol.io) as
`com.instapods/instapods`. `server.json` in this repo is the source of truth for that listing:
```bash
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=instapods"
```
To publish an update, bump `version` in `server.json`, then push a matching tag:
```bash
git tag mcp-v1.1.0 && git push origin mcp-v1.1.0
```
That runs [`.github/workflows/publish-mcp-registry.yml`](.github/workflows/publish-mcp-registry.yml),
which publishes via `mcp-publisher`. The registry rejects a version that already exists, so every
publish needs a new `version`.
Authentication is domain-based: the registry namespace `com.instapods/*` is proved by the Ed25519
public key served at `https://instapods.com/.well-known/mcp-registry-auth`. The workflow signs with
the matching private key from the `MCP_REGISTRY_PRIVATE_KEY` repo secret. GitHub OIDC is not an
option here — it only grants the `io.github.*` namespace.
## Links
- [InstaPods Dashboard](https://app.instapods.com)
- [Documentation](https://docs.instapods.com)
- [CLI Releases](https://github.com/InstaPods/sdk/releases)
- [MCP Registry listing](https://registry.modelcontextprotocol.io/v0/servers?search=instapods)
## License
MIT