List Servers

Overview

Returns a list of all available servers in the ToolRouter marketplace. These servers contain various tools that you can add to your stacks and use in your applications.

Endpoint

GET https://api.toolrouter.ai/v1/servers

Authentication

This endpoint requires an API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Response

array

Array of available server objects

Show Server Object

string

Unique identifier for the server

string

Human-readable name of the server

string

Description of the server’s functionality

array

Array of tools available in this server

Show Tool Object

string

Unique identifier for the tool

string

Name of the tool

string

Description of the tool’s functionality

object

JSON schema defining the tool’s input parameters

array

Array of required credential fields for this server

Show Credential Object

string

Unique identifier for the credential field

string

Human-readable name of the credential

string

Description of what this credential is used for

boolean

Whether this credential is required (always true for required_credentials)

array

Array of optional credential fields for this server

Show Credential Object

string

Unique identifier for the credential field

string

Human-readable name of the credential

string

Description of what this credential is used for

boolean

Whether this credential is required (always false for optional_credentials)

Example Request

curl -X GET "https://api.toolrouter.ai/v1/servers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

import requests

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

response = requests.get(
    "https://api.toolrouter.ai/v1/servers",
    headers=headers
)

servers = response.json()

const response = await fetch('https://api.toolrouter.ai/v1/servers', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const servers = await response.json();

Example Response

[
  {
    "server_id": "gmail",
    "name": "Gmail Server",
    "description": "Integration with Gmail for email management",
    "tools": [
      {
        "tool_id": "gmail_send_email",
        "name": "Send Email",
        "description": "Send an email through Gmail",
        "parameters": {
          "type": "object",
          "properties": {
            "to": {
              "type": "array",
              "items": {"type": "string"},
              "description": "List of recipient email addresses"
            },
            "subject": {
              "type": "string",
              "description": "Email subject"
            },
            "body": {
              "type": "string",
              "description": "Email body content"
            }
          },
          "required": ["to", "subject", "body"]
        }
      },
      {
        "tool_id": "gmail_search_emails",
        "name": "Search Emails",
        "description": "Search for emails using Gmail search syntax",
        "parameters": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "Gmail search query"
            },
            "maxResults": {
              "type": "number",
              "description": "Maximum number of results to return"
            }
          },
          "required": ["query"]
        }
      }
    ],
    "required_credentials": [
      {
        "field_id": "gmail_oauth_token",
        "name": "Gmail OAuth Token",
        "description": "OAuth token for Gmail API access",
        "required": true
      }
    ],
    "optional_credentials": [
      {
        "field_id": "gmail_signature",
        "name": "Email Signature",
        "description": "Default signature to append to emails",
        "required": false
      }
    ]
  },
  {
    "server_id": "linear",
    "name": "Linear",
    "description": "Project management and issue tracking with Linear",
    "tools": [
      {
        "tool_id": "linear_create_issue",
        "name": "Create Issue",
        "description": "Create a new issue in Linear",
        "parameters": {
          "type": "object",
          "properties": {
            "title": {
              "type": "string",
              "description": "Issue title"
            },
            "description": {
              "type": "string",
              "description": "Issue description"
            },
            "teamId": {
              "type": "string",
              "description": "Team ID"
            }
          },
          "required": ["title", "teamId"]
        }
      }
    ],
    "required_credentials": [
      {
        "field_id": "linear_api_key",
        "name": "Linear API Key",
        "description": "API key for Linear integration",
        "required": true
      }
    ],
    "optional_credentials": []
  }
]

Use Cases

This endpoint is useful for:

Discovering available integrations: See all servers and tools available in the marketplace
Understanding tool capabilities: Review tool parameters and descriptions before adding to stacks
Planning stack configuration: Determine which servers and tools to include in your stacks
Credential planning: Understand what credentials you’ll need to set up before adding servers

Error Responses

Invalid or missing API key

{
  "detail": "Unauthorized"
}

Rate limit exceeded

{
  "detail": "Too many requests"
}

Server error occurred

{
  "detail": "Failed to get servers"
}

API Documentation

Stack Specific Endpoints

Account Management API

Stack Management

Server Management

Credentials Management

Tools Management

SDK

Overview

Endpoint

Authentication

Response

Example Request

Example Response

Use Cases

Error Responses

​Overview

​Endpoint

​Authentication

​Response

​Example Request

​Example Response

​Use Cases

​Error Responses

Overview

Endpoint

Authentication

Response

Example Request

Example Response

Use Cases

Error Responses