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:
Ask the MCP client to prepare an export.
DIDWW validates the selected export type and filters.
DIDWW prepares the file in the background.
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.