Getting Started

Step 1 — Sign in to Runstack

Go to the Runstack web app and sign in or create an account. Once signed in you'll have access to the Settings page where API keys are managed.

Step 2 — Connect a service

Before a tool can be used it needs the relevant OAuth connection. Head to Connectors in the sidebar and connect whichever service you want to use (e.g. GitHub).

Each connector has an OAuth2 flow — click the connector, then Connect, and follow the provider's sign-in screens. Runstack stores the resulting access token securely and injects it automatically when tools are executed.

Step 3 — Create an API key

Go to Settings → API Keys and create a new key:

1. Enter a descriptive name (e.g. Claude Desktop or My Script)
2. Select a plan tier:
   • FREE — 50 tool executions
   • STARTER — Unlimited
   • PRO — Unlimited + private endpoints
3. Click Create Key
4. Copy the key immediately — it is shown only once

Your key looks like: rsk_a1b2c3d4e5f6...

Step 4 — Add Runstack to your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "runstack": {
      "url": "https://app.runstack.engineer/mcp",
      "headers": {
        "Authorization": "Bearer rsk_YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. You'll see the Runstack tools available in the tool panel.

Cursor

Add to your Cursor MCP settings:

{
  "runstack": {
    "url": "https://app.runstack.engineer/mcp",
    "headers": {
      "Authorization": "Bearer rsk_YOUR_API_KEY"
    }
  }
}

Step 5 — Run your first tool

In Claude Desktop (or your MCP client), try:

"Search for GitHub tools and create an issue in my repo called test-repo with title 'Hello from MCP'"

The AI will:

1. Call search_tools with pattern github.*issue
2. Call check_authentication to verify your GitHub connection
3. Call execute_tool with github_create_issue and the right arguments

That's it — you're now running Runstack tools from any MCP client.