​
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

​
servers
array
Array of available server objects

​
Example Request

curl -X GET "https://api.toolrouter.ai/v1/servers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/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

​
401 Unauthorized
Invalid or missing API key
{
  "detail": "Unauthorized"
}
​
429 Too Many Requests
Rate limit exceeded
{
  "detail": "Too many requests"
}
​
500 Internal Server Error
Server error occurred
{
  "detail": "Failed to get servers"
}