# List a remote MCP connector's tool registry

> Source: https://elaichi.ai/docs/api-reference/custom-connectors/connector/listremotemcpconnectortools/

`GET /connector/{slug}/tool`

Resource: **Connector** · API: **Custom connectors**

## Path parameters

- **`slug`** _(string, required)_
  Connector slug of an org-owned remote MCP connector.

## Query parameters

- **`q`** _(string)_
  Substring of the name, upstream name, title or description. LIKE wildcards are matched literally. Max 200 characters.
- **`status`** _(string)_
  Only tools that are on (`active`) or off (`disabled`). Managers only; a `use` grantee always gets `active`.
  Allowed: `active`, `disabled`
- **`tier`** _(array<string>)_
  Only tools whose stored tier is this one, or any of several: a comma list (`tier=read,write`) or the parameter repeated. It is the tier the gate enforces, so `tier=destructive` includes the tools the server left unlabeled (`tier_source: "default"`). Pair with `labeled=true` for server labels only. Empty is no filter; any value that is not `read`, `write` or `destructive` is a 400.
- **`labeled`** _(string)_
  `true`: only tools the server labeled itself (`tier_source: "server"`); `false`: only the ones it left unlabeled. Empty is no filter; any other value is a 400.
  Allowed: `true`, `false`

## Response body

- **`result`** _(array<object>)_
- **`next_cursor`** _(string,null)_
- **`prev_cursor`** _(string,null)_
- **`match_count`** _(integer)_
  How many tools match this request's `q` / `tier` / `labeled` (and the caller's `status`), counted on the server. Only on a first page of a narrowed list; absent otherwise.

## Code examples

### curl

```bash
curl -X GET 'https://api.elaichi.ai/connector/<slug>/tool' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
```

### JavaScript

```javascript
const response = await fetch('https://api.elaichi.ai/connector/<slug>/tool', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
```

### Python

```python
import os
import requests

url = "https://api.elaichi.ai/connector/<slug>/tool"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())
```