Documentation | shipable

shipable MCP

This guide explains how to use the shipable MCP (Model Context Protocol) server over HTTP. Authentication is work in progress.

Public Endpoint

• Base URL: https://mcp.shipable.dev/mcp/
• Protocol: JSON-RPC 2.0 over HTTP POST
• Content-Type: application/json

Quick Start (HTTP)

List available tools:

bash

curl -s -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"list","method":"tools/list"}' \
  https://mcp.shipable.dev/mcp/

Call a tool (chat):

bash

curl -s -X POST \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "chat-1",
    "method": "tools/call",
    "params": {
      "name": "chat",
      "arguments": {
        "app_id": "your-app-id",
        "user_id": "your-user-id",
        "question": "What did we set as the app\'s subtitle?",
        "history": [{ "role": "user", "content": "Hi" }]
      }
    }
  }' \
  https://mcp.shipable.dev/mcp/

Cheap pre-check (evaluate_request):

bash

curl -s -X POST \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "eval-1",
    "method": "tools/call",
    "params": { "name": "evaluate_request", "arguments": { "user_prompt": "Please update my app" } }
  }' \
  https://mcp.shipable.dev/mcp/

Health:

bash

curl -s -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"health","method":"tools/call","params":{"name":"health_check","arguments":{}}}' \
  https://mcp.shipable.dev/mcp/

Try it on Claude Code (terminal)

Claude Code can register HTTP MCP servers directly via the CLI. Run:

bash

claude mcp add --transport http shipable-agent https://mcp.shipable.dev/mcp/

This registers the server and exposes tools (chat, evaluate_request, health_check).

Using it with Cursor

Cursor supports HTTP MCP servers via .cursor/mcp.json. Add this to your project:

json

{
  "mcpServers": {
    "shipable": {
      "url": "https://mcp.shipable.dev/mcp/"
    }
  }
}

Current Tools

chat(app_id, user_id, question, history?) → { answer, total_tokens?, message_id? }

– Conversational agent for managing your App in the App Store and deploy updates.

evaluate_request(user_prompt) → "yes" | "no" | "partially" | "unsure"

– Low-cost judge to decide if chat likely helps before spending more tokens.

health_check() → "ok"

– Liveness probe for the MCP tool surface.

Authentication (Work in Progress)

The HTTP endpoint currently accepts requests without auth.