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

# Llamadas y conectores

> Las herramientas MCP de RoofKit para Llamadas y conectores, con su acceso, tipo y argumentos.

Esta página lista 13 herramientas. Cada herramienta aparece solo para los miembros cuyo rol concede su acceso. Las descripciones son el texto que el servidor MCP envía a los clientes de IA, en inglés.

## List tracking numbers

List tracking numbers with their label, attribution (source, medium, campaign), pool, and updated\_at. SMS bodies are never returned.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.numbers.list` | `communications.manage` | Lectura |

**Argumentos**

Esta herramienta no recibe argumentos.

## List calls

List the latest 50 calls with their outcome tag, without caller phone numbers. For a recording, call roofkit.communications.recordings.playback\_link.get with the call id.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.calls.list` | `communications.manage` | Lectura |

**Argumentos**

Esta herramienta no recibe argumentos.

## Get JobNimbus status

Deprecated: use roofkit.integrations.status with provider jobnimbus. This alias stays for one release. Read JobNimbus connection status. Do not send API keys in the tool body.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.integrations.jobnimbus.status` | `integrations.manage` | Lectura |

**Argumentos**

Esta herramienta no recibe argumentos.

## Get connector status

Read the status of the native integrations: status, connected, last health check, last successful sync, the last sync run, and the last error with a safe error type. Send provider for one, or omit it for all. It never returns credentials. Connect and disconnect stay in Settings: use settings\_handoff\_url.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.integrations.status` | `integrations.manage` | Lectura |

**Argumentos**

**provider** `string`

jobnimbus, meta\_ads, google\_ads, microsoft\_ads, or google\_analytics. Valores permitidos: `jobnimbus`, `meta_ads`, `google_ads`, `microsoft_ads`, `google_analytics`.

## List connector sync runs

List the recent sync runs of one integration, newest first, with status, counts, and the error type. limit is 1 to 50, default 20. A status filter reads the newest 200 runs. For google\_analytics each run is one conversion event delivery.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.integrations.sync_runs.list` | `integrations.manage` | Lectura |

**Argumentos**

**provider** `string` *required*

jobnimbus, meta\_ads, google\_ads, microsoft\_ads, or google\_analytics. Valores permitidos: `jobnimbus`, `meta_ads`, `google_ads`, `microsoft_ads`, `google_analytics`.

**status** `string`

Valores permitidos: `queued`, `running`, `succeeded`, `failed`, `skipped`.

**limit** `integer`

Mínimo 1. Máximo 50.

## Refresh connector health

Check the saved connection with the provider now, as the Refresh button in Settings does. It calls the provider API, records a connection check, and updates the connection status. It returns the new status. A connector with no saved credential answers refreshed: false.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.integrations.health.refresh` | `integrations.manage` | Escritura |

**Argumentos**

**provider** `string` *required*

meta\_ads, google\_ads, microsoft\_ads, or google\_analytics. Valores permitidos: `meta_ads`, `google_ads`, `microsoft_ads`, `google_analytics`.

## Retry connector sync run

Retry a failed or skipped sync run, as the Retry button in Settings does. For meta\_ads, google\_ads, and microsoft\_ads it does not replay that one run: it queues a full catalog and insights sync of the connection. For google\_analytics it queues that one conversion event again, which sends it to Google Analytics. Requires an idempotency key.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.integrations.sync_runs.retry` | `integrations.manage` | Escritura |

**Argumentos**

**provider** `string` *required*

meta\_ads, google\_ads, microsoft\_ads, or google\_analytics. Valores permitidos: `meta_ads`, `google_ads`, `microsoft_ads`, `google_analytics`.

**idempotency\_key** `string` *required*

**run\_id** `string` *required*

A run id from roofkit.integrations.sync\_runs.list.

## List DNI pools

List the active and paused DNI pools, highest priority first: name, type, status, match rules, fallback, exhaustion mode, numbers, and updated\_at. Send updated\_at as expected\_updated\_at to roofkit.communications.pools.save. Forwarding and whisper settings stay in the app.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.pools.list` | `communications.manage` | Lectura |

**Argumentos**

Esta herramienta no recibe argumentos.

## Update tracking number

Update the attribution (source, medium, campaign) or the label of one tracking number. Only the fields sent change, and calls and texts that arrive later carry them. A label alone is the legacy "source / campaign" form. Send expected\_updated\_at from roofkit.communications.numbers.list to refuse the write over a newer change. The forwarding destination, purchase, and release stay in the app.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.numbers.update` | `communications.manage` | Escritura |

**Argumentos**

**tracking\_number\_id** `string` *required*

A number id from roofkit.communications.numbers.list.

**source** `string`

Where callers see the number, for example google. Como máximo 100 caracteres.

**medium** `string`

For example cpc or organic. An empty string clears it. Como máximo 100 caracteres.

**campaign** `string`

An empty string clears it. Como máximo 100 caracteres.

**label** `string`

Legacy "source / campaign" label. Prefer source and campaign. Como máximo 200 caracteres.

**expected\_updated\_at** `string`

## Set number DNI pool

Move one tracking number into an active DNI pool, or out of every pool with pool\_id null. A number sits in one pool at most. Website visitors get numbers from the new pools at once. The Phone System plan caps the pool size.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.pools.membership.set` | `communications.manage` | Escritura |

**Argumentos**

**tracking\_number\_id** `string` *required*

A number id from roofkit.communications.numbers.list.

**pool\_id** `string | null` *required*

A pool id, or null to leave every pool.

## Save DNI pool

Create a DNI pool, or change the rules of one pool: name, type, status, match rules, priority, fallback, exhaustion mode, and numbers. A rule the call leaves out keeps its value. Website visitors get numbers by the new rules at once. Overlapping rules answer CONFLICT. Forwarding and whisper settings stay in the app.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.pools.save` | `communications.manage` | Escritura |

**Argumentos**

**pool\_id** `string`

The pool to change. Leave it out to create a pool.

**name** `string`

Como máximo 120 caracteres.

**type** `string`

Valores permitidos: `static`, `dni_pool`, `landing`, `source_campaign`, `fallback`.

**status** `string`

Valores permitidos: `active`, `paused`.

**priority** `number`

**source** `string`

Where callers see the number, for example google. Como máximo 100 caracteres.

**medium** `string`

For example cpc or organic. An empty string clears it. Como máximo 100 caracteres.

**campaign** `string`

An empty string clears it. Como máximo 100 caracteres.

**content** `string`

Como máximo 100 caracteres.

**referrer\_pattern** `string`

Como máximo 200 caracteres.

**is\_default** `boolean`

**fallback\_pool\_id** `string`

**default\_tracking\_number\_id** `string`

**exhaustion\_mode** `string`

Valores permitidos: `fallback_pool`, `static_default`, `keep_original`, `block`.

**assigned\_tracking\_number\_ids** `string[]`

Every number of the pool.

**session\_ttl\_minutes** `number`

Mínimo 1. Máximo 1440.

**expected\_updated\_at** `string`

updated\_at of the pool from roofkit.communications.pools.list.

## Set call outcome tag

Set "What happened" on one call: booked, quoted, not\_a\_fit, or spam, or null to clear it. The tag shows at once in the call log and the call reports. Send expected\_outcome\_tag from roofkit.communications.calls.list to refuse the write with CONFLICT when someone changed the tag first.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.calls.outcome.set` | `communications.manage` | Escritura |

**Argumentos**

**call\_id** `string` *required*

A call id from roofkit.communications.calls.list.

**outcome\_tag** `string | null` *required*

Valores permitidos: `booked`, `quoted`, `not_a_fit`, `spam`, `null`.

**expected\_outcome\_tag** `string | null`

The tag as you read it. Null means no tag. Valores permitidos: `booked`, `quoted`, `not_a_fit`, `spam`, `null`.

## Get call recording link

Return a playback link for the recording of one call. The link works for 15 minutes without sign-in, so share it only with people who may hear the call. The request and every play are logged in the recording access log of the workspace. Needs communications.manage too.

| Nombre de la herramienta | Acceso | Tipo |
| - | - | - |
| `roofkit.communications.recordings.playback_link.get` | `communications.recordings.playback` | Lectura |

**Argumentos**

**call\_id** `string`

A call id from roofkit.communications.calls.list.

**recording\_id** `string`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.