Programmatic Access

https://semaphor.cloud/api/mcp

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://semaphor.cloud/api/mcp'),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${process.env.SEMAPHOR_TOKEN}`,
      },
    },
  }
);

const client = new Client({ name: 'my-agent', version: '1.0.0' });
await client.connect(transport);

// List available tools
const { tools } = await client.listTools();
console.log('Available tools:', tools.map(t => t.name));

// Call a tool
const result = await client.callTool({
  name: 'semaphor_get_analysis_context',
  arguments: {},
});
console.log(result);

curl -X POST https://semaphor.cloud/api/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

curl -X POST https://semaphor.cloud/api/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "semaphor_get_analysis_context",
      "arguments": {}
    },
    "id": 2
  }'

curl -X POST https://semaphor.cloud/api/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "semaphor_query_sql",
      "arguments": {
        "connectionId": "conn_abc123",
        "sql": "SELECT region, COUNT(*) as orders FROM orders GROUP BY region"
      }
    },
    "id": 3
  }'

import requests

TOKEN = "your_project_token"
ENDPOINT = "https://semaphor.cloud/api/mcp"

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Content-Type": "application/json",
}

# Get analysis context
response = requests.post(
    ENDPOINT,
    headers=headers,
    json={
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "semaphor_get_analysis_context",
            "arguments": {},
        },
        "id": 1,
    },
)

print(response.json())

const TOKEN = process.env.SEMAPHOR_TOKEN;
const ENDPOINT = 'https://semaphor.cloud/api/mcp';

// List dashboards
const response = await fetch(ENDPOINT, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/call',
    params: {
      name: 'semaphor_list_dashboards',
      arguments: { projectId: 'p_abc123' },
    },
    id: 1,
  }),
});

const result = await response.json();
console.log(result);