# Get an MCP call

`GET /api/v1/mcp-calls/{mcpCall}`

Retrieve one call an assistant made to your account through MCP.

This endpoint also answers QUERY, with the same parameters sent in the request body. [How QUERY works](https://my.monicahq.com/docs/api/query-method).

## Path parameters

- `mcpCall` (uuid, required): The id of the call.

## Returns

A call. A call from another account answers 404.

- `data` (object): The call.
- `data.type` (string): Always mcp_call. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.
- `data.id` (string): The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.
- `data.attributes` (object): Everything the record holds.
- `data.attributes.started_at_in_milliseconds` (integer): When the call started, as a count of milliseconds since 1970. Milliseconds rather than seconds, because an assistant often makes several calls within the same second.
- `data.attributes.duration_in_milliseconds` (integer): How long the tool took, or null while the call is interrupted.
- `data.attributes.connection` (object): What the assistant connected with.
- `data.attributes.connection.type` (string): api_key for an API key, oauth_client for an assistant connected through OAuth.
- `data.attributes.connection.id` (string): The id of the key or of the OAuth client. It stays after the key is revoked or the assistant disconnected.
- `data.attributes.connection.name` (string): The name the connection had when the call was made. It is the name you or the assistant chose, not a verified identity of whoever made the assistant.
- `data.attributes.tool` (string): The name of the tool, as the assistant sent it, such as get-contact.
- `data.attributes.operation` (string): read, create, update or delete, taken from the API endpoint the tool mirrors. Null for a tool that does not exist.
- `data.attributes.vault` (object): The vault the call reached, or null when it named none inside your account.
- `data.attributes.vault.id` (uuid): The id of the vault, or null once the vault is deleted.
- `data.attributes.vault.name` (string): The name the vault had when the call was made.
- `data.attributes.subject` (object): The record the call reached, or null when it reached none inside your account.
- `data.attributes.subject.type` (string): What kind of record it is, such as contact or life_event.
- `data.attributes.subject.label` (string): The name the record had when the call was made.
- `data.attributes.result` (string): succeeded, refused, invalid_parameters, error or interrupted. It is read from what the tool answered, never from the HTTP status, which is 200 for a failed tool call too. A call that started and never finished stays interrupted.
- `data.attributes.error` (object): Why the call did not succeed, or null when it did.
- `data.attributes.error.code` (integer): The JSON-RPC code: -32602 when the parameters or the record were refused, -32603 for anything else.
- `data.attributes.error.message` (string): The reason sent to the assistant, word for word.
- `data.attributes.json_rpc_id` (string): The id the assistant gave the request, as a string.
- `data.attributes.ip_address` (string): The address the request came from, up to 45 characters.
- `data.attributes.parameters` (string): The parameters the assistant sent, as JSON, with secrets and the values of sensitive fields masked before they were stored.
- `data.attributes.parameters_truncated` (boolean): Whether the parameters were longer than 16 384 bytes and only their beginning was kept, in which case parameters is not valid JSON.
- `data.attributes.response` (string): The response the assistant received, as JSON, masked the same way, or null when the call ended in a JSON-RPC error.
- `data.attributes.response_truncated` (boolean): Whether the response was cut the same way.
- `data.links` (object): Where to find this record.
- `data.links.self` (string): The absolute address this record is read from.

## Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in `X-RateLimit-Remaining`.

## Request

```sh
curl https://my.monicahq.com/api/v1/mcp-calls/5b1f0e9c-2d4a-4c7e-8b36-1a9e7d2c4f03 \
  -H "Authorization: Bearer $MONICA_TOKEN"
```

```javascript
const response = await fetch('https://my.monicahq.com/api/v1/mcp-calls/5b1f0e9c-2d4a-4c7e-8b36-1a9e7d2c4f03', {
  headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
```

```php
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/mcp-calls/5b1f0e9c-2d4a-4c7e-8b36-1a9e7d2c4f03');
```

## Response

`200`

```json
{
    "data": {
        "type": "mcp_call",
        "id": "5b1f0e9c-2d4a-4c7e-8b36-1a9e7d2c4f03",
        "attributes": {
            "started_at_in_milliseconds": 1792765991204,
            "duration_in_milliseconds": 21,
            "connection": {
                "type": "oauth_client",
                "id": "9a1f4c2e-7b3d-4f8a-a6e1-3c5d9b2e7f14",
                "name": "Claude"
            },
            "tool": "update-life-event",
            "operation": "update",
            "vault": {
                "id": "0f7e2c1a-6b3d-4e59-8a21-5c9d3b7e1f60",
                "name": "Dunder Mifflin"
            },
            "subject": {
                "type": "life_event",
                "label": "Dundies"
            },
            "result": "invalid_parameters",
            "error": {
                "code": -32602,
                "message": "The happened on field must match the format Y-m-d."
            },
            "json_rpc_id": "8",
            "ip_address": "192.168.1.24",
            "parameters": "{\"vault\":\"dunder-mifflin\",\"life_event\":\"7c2e9a14-3b5d-4f61-8e27-9d1a4c6b2f85\",\"happened_on\":\"31/02/1978\"}",
            "parameters_truncated": false,
            "response": "{\"content\":[{\"type\":\"text\",\"text\":\"The happened on field must match the format Y-m-d.\"}],\"isError\":true}",
            "response_truncated": false
        },
        "links": {
            "self": "https://my.monicahq.com/api/v1/mcp-calls/5b1f0e9c-2d4a-4c7e-8b36-1a9e7d2c4f03"
        }
    }
}
```
