Workjet
Back to Workjet

Tools API

The Tools API lets you manage MCP connector configurations programmatically. List available connectors, check connection status, and configure tools for assistants and engines. All endpoints require authentication.

Base URL

https://api.workjet.dev/v1

Endpoints

List Available Connectors

GET /tools

Returns all MCP connectors available in the catalog.

Response

{
  "tools": [
    {
      "id": "github",
      "name": "GitHub",
      "category": "development",
      "command": "npx @modelcontextprotocol/server-github",
      "requiredEnvVars": ["GITHUB_PERSONAL_ACCESS_TOKEN"],
      "description": "Interact with GitHub repositories, issues, and pull requests"
    }
  ],
  "total": 14
}

List Connected Tools

GET /tools/connections

Returns all active tool connections for the authenticated user.

Response

{
  "connections": [
    {
      "id": "conn_abc123",
      "toolId": "github",
      "name": "GitHub",
      "status": "connected",
      "connectedAt": "2026-04-01T10:00:00Z"
    }
  ]
}

Get Connection Status

GET /tools/connections/:id

Returns the status and details of a specific tool connection.

Test Connection

POST /tools/connections/:id/test

Triggers a health check on an existing connection and returns the result.

Response

{
  "id": "conn_abc123",
  "toolId": "github",
  "status": "connected",
  "lastTestedAt": "2026-04-14T15:30:00Z",
  "testResult": "ok"
}

Next Steps