# List IP addresses of virtual servers

> Every IPv4 and IPv6 address of the account's vServers.

- Effect: Read - Changes nothing.
- Idempotent: yes
- Stability: beta
- MCP tool: `manitu_vserver_ipaddress_list` on https://mcp.manitu.de/mcp
- REST: `POST https://api.manitu.de/v1/vserver/ipaddress/list`
- Needs: `service_vserver`
- Page: /reference/vserver/ipaddress/list/

## MCP tool

`manitu_vserver_ipaddress_list`

### Description for the model

Lists every IPv4 and IPv6 address of the virtual servers (vServers) of the manitu customer account - also of vServers this access may not see otherwise, but nothing else about them. For "which IP addresses do my servers have?" and for telling whether an address belongs to the account (e.g. in a DNS record). Which vServer has which address: manitu_vserver_list.

### Arguments

Takes no arguments.

### Example

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_vserver_ipaddress_list",
    "arguments": {}
  }
}
```

## REST

`POST https://api.manitu.de/v1/vserver/ipaddress/list`

### Authentication

One of `X-API-Key`, `Authorization: Bearer …` - never more than one in a request.

### Request body

JSON; unknown fields are refused.

No fields - send {} or no body.

### Response

In `data`; the rest of the body as on every call.

- `ipaddress_list` (array of string, required) - The addresses, IPv4 first, sorted.

### Statuses

- `200` Success.
- `400` The request does not match the declared input schema.
- `401` No credential was presented, or it was not recognised.
- `403` The credential is not permitted to use this operation.
- `500` The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.
- `503` The channel this operation forwards through is unavailable.

### Example

```sh
curl -X POST 'https://api.manitu.de/v1/vserver/ipaddress/list' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## Example result

```json
{
  "ipaddress_list": [
    "string"
  ]
}
```