MCP Quickstart

​

Interactive Testing Interface

• Multi-Account Selection: Choose multiple accounts to test with
• Tool Toggle: Exclude/include specific tools for each account
• Model Selection: Use different models than the default
• Real-time Testing: Start conversing immediately

​

Programmatic Testing

​

Step 1: Initialize Connection

curl -X POST https://api.stackone.com/mcp \
  -H 'Authorization: Basic <BASE64_APIKEY_COLON>' \
  -H 'x-account-id: <ACCOUNT_ID>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json,text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": "init-1",
    "method": "initialize",
    "params": {
      "clientInfo": {
        "name": "my-client",
        "version": "1.0.0"
      },
      "protocolVersion": "2025-06-18",
      "capabilities": {}
    }
  }'

{
  "jsonrpc": "2.0",
  "id": "init-1",
  "result": {
    "serverInfo": {
      "name": "stackone-mcp-server",
      "version": "1.0.0"
    },
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "tools": {},
      "logging": {}
    }
  }
}

​

Step 2: List Available Tools

curl -X POST https://api.stackone.com/mcp \
  -H 'Authorization: Basic <BASE64_APIKEY_COLON>' \
  -H 'x-account-id: <ACCOUNT_ID>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json,text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": "tools-1",
    "method": "tools/list"
  }'

{
  "jsonrpc": "2.0",
  "id": "tools-1",
  "result": {
    "tools": [
      {
        "name": "ashby_list_applications",
        "description": "List applications from Ashby",
        "inputSchema": {
          "type": "object",
          "properties": {
            "limit": {
              "type": "number"
            }
          }
        }
      }
    ]
  }
}

​

Step 3: Execute a Tool

curl -X POST https://api.stackone.com/mcp \
  -H 'Authorization: Basic <BASE64_APIKEY_COLON>' \
  -H 'x-account-id: <ACCOUNT_ID>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json,text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": "call-1",
    "method": "tools/call",
    "params": {
      "name": "ashby_list_applications",
      "arguments": {
        "limit": 10
      }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": "call-1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"data\": [\n    {\n      \"id\": \"emp_123\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"email\": \"john.doe@company.com\",\n      \"employment_status\": \"active\"\n    }\n  ],\n  \"pagination\": {\n    \"next_cursor\": \"abc123\"\n  }\n}"
        }
    ]
  }
}

​

Visual Debugging Interface

​

Installation & Setup

npx @modelcontextprotocol/inspector https://api.stackone.com/mcp

1. Select “HTTP” as the transport type (not STDIO)
2. Enter your authentication details:
   • Authorization: Basic <BASE64_APIKEY_COLON>
   • x-account-id: Your StackOne account ID

​

Using the Inspector

1. Connect: The inspector will automatically initialize and list available tools
2. Select Tool: Choose any tool from the sidebar
3. Configure Input: Fill in the required parameters in the form
4. Execute: Click “Call Tool” to see the response
5. Inspect: View both the formatted result and raw JSON

​

Documentation

​

GUI-Based Testing

​

Video Walkthrough

​

Setup Instructions

1. Download Postman: Get Postman from postman.com
2. Create a New Collection: Name it “StackOne MCP Testing”
3. Set Up Environment Variables:
   • Click “Environments” → “Create Environment” (you can use one environment per StackOne project to make it easier to handle multiple projects)
   • Add variable:
     • api_key = Your StackOne API key
4. Create MCP Request
   • Set-up protocol to HTTP not STDIO
   • The server url should be https://api.stackone.com/mcp
   • For Authorization, select Basic Auth and set username to your {{api_key}} environment variable
   • Go to headers and add x-account-id header with the StackOne account ID you want to use

​

Using the Server

1. Click the connect button on the right hand-side. This will do the initial connection with the MCP server and list all available tools
   • If successful, the response section will say connected
2. Go to the Message tab on the left of Authorization
3. You will see the list of Tools associated with the StackOne Account ID
4. Click on any of the tools and try/test them out!

​

Pro Tips

• Save Requests: Save each request in your collection for reuse and easy sharing with your team.
• Use the Tests Tab: Add validation scripts in Postman’s Tests tab to automatically verify responses.
• Share Collections: Export and share collections with teammates to standardize testing.
• Try Other Tools: Use the tools listed in Step 2’s response to experiment with different operations.

​

Key Points