InstaPods

Claude、Cursor、または任意のMCPクライアントからホスティングポッドをデプロイおよび管理します。ローカルホストからライブURLへワンステップで。

ドキュメント

InstaPods SDK

Tools and integrations for deploying and managing apps on InstaPods 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:

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.

License

MIT