> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tools

> Returns the list of registered tools.

## Endpoint

`GET https://gateway.orkeia.ai/tools`

**Authentication**\
Requires header `authorization:  <your_token>`.

## Example (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/tools"   -H "authorization:  <your_token>"
```

## Responses

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "TOOL_123456",
      "name": "Tool X",
      "description": "Description of the tool",
      "code": "export async function run(input){ return { ok: true }; }",
      "entryFunctionName": "run",
      "sectors": ["engineering"],
      "publisher": "Orkeia",
      "enabled": true,
      "environments": ["prod"],
      "mcp": {
        "url": "https://tools.orkeia.ai/my-tool",
        "transport": "sse"
      },
      "createdAt": "2024-07-15T14:25:18.000Z"
    }
  ]
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```

## Fields

| Field             | Type                       | Description                                   |
| ----------------- | -------------------------- | --------------------------------------------- |
| id                | string                     | ID of the tool.                               |
| name              | string                     | Name of the tool.                             |
| description       | string                     | Description of the tool.                      |
| code              | string                     | Executable code associated (when applicable). |
| entryFunctionName | string                     | Entry function in `code`.                     |
| sectors           | string\[]                  | Allowed sectors.                              |
| publisher         | string                     | Who published/created the tool.               |
| enabled           | boolean                    | Indicates if it is enabled.                   |
| environments      | string\[]                  | Environments in which it is available.        |
| mcp               | object                     | MCP configuration (when applicable).          |
| mcp.url           | string                     | URL of the MCP.                               |
| mcp.transport     | 'sse' \| 'streamable-http' | Type of MCP transport.                        |
| createdAt         | string                     | Creation date in ISO 8601 format.             |