InstaPods SDK
Tools and integrations for deploying and managing apps on InstaPods with AI assistants.
InstaPods is app hosting for developers — real Linux servers, one command. Deploy Node.js, Python, PHP, and static apps in seconds. 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:
-
Install the CLI:
curl -fsSL https://instapods.com/install.sh | sh instapods auth login -
Copy the skill to your project:
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 -
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:
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):
{
"mcpServers": {
"instapods": {
"url": "https://app.instapods.com/api/mcp"
}
}
}
On first use, Claude will walk you through OAuth authentication. See 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 as
com.instapods/instapods. server.json in this repo is the source of truth for that listing:
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=instapods"
To publish an update, bump version in server.json, then push a matching tag:
git tag mcp-v1.1.0 && git push origin mcp-v1.1.0
That runs .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
License
MIT