# Exports with DIDWW MCP

Use DIDWW MCP to prepare supported account-data exports through a connected MCP
client. You can request an export, monitor its progress, and obtain a
download link when the file is ready.

Note

Exports are created asynchronously. The MCP client does not need to remain
open while DIDWW prepares the file.

## Supported export types

| Export | Information included | Available filters |
| --- | --- | --- |
| Inbound call records | Records for incoming calls available to the active DIDWW account. | A date range is required. A phone-number filter can be provided when applicable. |
| Outbound call records | Records for outgoing calls available to the active DIDWW account. | A date range is required. A phone-number filter can be provided when applicable. |
| Inbound SMS logs | Records for incoming SMS messages. | A date range is required. A phone-number filter can be provided when applicable. |
| Outbound SMS logs | Records for outgoing SMS messages. | A date range is required. A phone-number filter can be provided when applicable. |
| Phone numbers | Phone-number records available to the active DIDWW account. | A date range is not accepted. A phone-number export always covers the current records. |
| Orders | Order records available to the active DIDWW account. | A date range is optional. |
| Payments | Payment records available to the active DIDWW account. | A date range is optional. |

## What you can do

Describe the export you need in plain language. Identify the relevant account,
record type, date range, and phone number when applicable.

| Action | What you can request |
| --- | --- |
| Create an export | Request a supported export using the applicable date and phone-number filters. |
| Review prepared exports | List exports created for the active DIDWW account and review their type, filters, and current status. |
| Check export status | Check whether a requested export is pending, processing, or completed. |
| Download a completed export | Obtain a download link after the export is completed. DIDWW returns a direct link that opens without a User Panel sign-in, and a User Panel link for signed-in access. |

## How exports work

The export workflow has four stages:

1. Ask the MCP client to prepare an export.
2. DIDWW validates the selected export type and filters.
3. DIDWW prepares the file in the background.
4. Ask the MCP client to check the status and provide the download link.

Preparing an export can take several minutes. Because the MCP connection does
not send a completion notification, ask the MCP client to check the export
status after waiting for the preparation period shown in the response.

## Export statuses

| Status | Meaning |
| --- | --- |
| Pending | DIDWW accepted the export request, but processing has not started. |
| Processing | DIDWW is preparing the export file. |
| Completed | The file is ready and a download link can be requested. |

## Date requirements

Inbound and outbound call-record and SMS-log exports require a valid date
range.

The requested dates must:

- fall within the current month or the two previous calendar months
- include a start date that is earlier than the end date
- not include future dates

If a requested end date extends beyond the current time, DIDWW may adjust it to
the current time and identify the adjusted range in the response.

Order and payment exports can use an optional date range. A phone-number export
does not accept a date range, and DIDWW rejects the request when one is
supplied.

## Download and retention

When an export is completed, the MCP client can provide two download links:

- a **direct link** that opens the file without a DIDWW User Panel sign-in. It
  works in any browser and remains valid until the file is deleted.
- a **User Panel link** that requires a signed-in DIDWW user with permission to
  access the export.

The export file remains available for one month. Both links stop working when
the file is deleted.

Warning

The direct link grants access to the export file to anyone who has it.
Treat it as confidential and do not forward it.

## Permissions

Export availability depends on the permissions assigned to the DIDWW user:

- call-record and SMS-log exports require access to the relevant logs
- phone-number exports require phone-number export permission
- order and payment exports require billing permission

An export created by another DIDWW account is not available through the active
account connection.

If your user can access multiple DIDWW accounts, ask the MCP client to show
the active account before creating the export.

## Current limitations

DIDWW MCP does not currently:

- return the complete export file inside the MCP client conversation
- send a notification when an export finishes
- prepare invoice PDF exports
- prepare export types other than those listed on this page

## Example requests

Export phone number records

```
Prepare an export of the phone numbers in the active DIDWW account.
Tell me the export identifier and its current status.
```

Export inbound call records

```
Prepare an inbound call-record export for +370XXXXXXXX.
Include records from 2026-08-01 through the current time.
Tell me when I should check the export status.
```

Export outbound call records

```
Prepare an outbound call-record export for July 2026.
Use the active DIDWW account.
Tell me the export identifier and its current status.
```

Export inbound SMS logs

```
Prepare an inbound SMS log export for +1202XXXXXXX.
Include records from 2026-08-01 through the current time.
Tell me when I should check the export status.
```

Export outbound SMS logs

```
Prepare an outbound SMS log export for July 2026.
Use the active DIDWW account.
Tell me the export identifier and its current status.
```

Export orders

```
Prepare an export of orders created during July 2026.
Do not create any purchases or payments.
```

Export payments

```
Prepare an export of payments received during July 2026.
Do not create a new payment.
```

Check and download an export

```
Check the status of export EXAMPLE-EXPORT-ID.
If it is completed, provide the download link.
Do not create another export.
```

On this page