{
  "info": {
    "name": "Telnyx — mcp.ai",
    "description": "REST API for the Telnyx MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/telnyx",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "telnyx_create_network",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/network",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "network"
          ]
        },
        "description": "Tool to create a new network. Use when you need to provision a fresh network resource before connecting devices.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_create_notification_channel",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/notification/channel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "notification",
            "channel"
          ]
        },
        "description": "Tool to create a notification channel. Use when you need to register a channel (SMS, voice, email, or webhook) to receive notifications. E.g., create a webhook channel for event callbacks.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel_type_id\": \"\",\n  \"channel_destination\": \"\",\n  \"notification_profile_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_create_notification_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/notification/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "notification",
            "profile"
          ]
        },
        "description": "Tool to create a notification profile. Use when you need to register a new profile to group notification channels (SMS and voice) and define notification settings. Must be called before TELNYX_CREATE_",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_create_notification_setting",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/notification/setting",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "notification",
            "setting"
          ]
        },
        "description": "Tool to add a notification setting. Use after creating the event condition, profile, and channel. All three UUID parameters must be fetched dynamically from their respective list/create endpoints; har",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"parameters\": \"\",\n  \"notification_channel_id\": \"\",\n  \"notification_profile_id\": \"\",\n  \"notification_event_condition_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_delete_network",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/network",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "network"
          ]
        },
        "description": "Tool to delete a network by ID. Use when you have obtained the network's identifier and need to remove it permanently.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"network_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_delete_notification_channel",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/notification/channel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "notification",
            "channel"
          ]
        },
        "description": "Tool to delete a notification channel by ID. Use when you have the channel's identifier and need to remove it permanently.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"notification_channel_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_delete_notification_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/notification/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "notification",
            "profile"
          ]
        },
        "description": "Tool to delete a notification profile by ID. Use when you have the profile's identifier and need to remove it permanently.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"notification_profile_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_delete_notification_setting",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/notification/setting",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "notification",
            "setting"
          ]
        },
        "description": "Tool to delete a notification setting by ID. Use when you need to permanently remove an existing notification setting before reconfiguration.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"notification_setting_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_get_black_box_test_results",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/black/box/test/results",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "black",
            "box",
            "test",
            "results"
          ]
        },
        "description": "Tool to retrieve black box test results from Telnyx SETI Observability. Use when you need to check service health and test results, optionally filtering by product.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"filter\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_get_user_balance",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user/balance",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user",
            "balance"
          ]
        },
        "description": "Tool to retrieve the current user account balance and credit details. Use after authenticating your account to check available balance.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_audit_logs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/audit/logs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "audit",
            "logs"
          ]
        },
        "description": "Tool to retrieve a list of audit log entries for your account. Use when you need to review recent resource changes with optional pagination and date filters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"filter_created_after\": \"\",\n  \"filter_created_before\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_connections",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/connections",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "connections"
          ]
        },
        "description": "Tool to retrieve all connections in your account. Use when you need to list connections with pagination, filtering, and sorting.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"connection_name_contains\": \"\",\n  \"outbound_voice_profile_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_dynamic_emergency_endpoints",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/dynamic/emergency/endpoints",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "dynamic",
            "emergency",
            "endpoints"
          ]
        },
        "description": "Tool to list dynamic emergency endpoints. Use when you need to retrieve dynamic emergency endpoint records, optionally filtered by status or country. Example: \"List all activated endpoints in US\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"status\": \"\",\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"country_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_global_ip_health_check_types",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/global/ip/health/check/types",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "global",
            "ip",
            "health",
            "check",
            "types"
          ]
        },
        "description": "Tool to list all available global IP health check types. Use when you need to retrieve supported health check types for global IP configurations.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_messaging_profiles",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/messaging/profiles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "messaging",
            "profiles"
          ]
        },
        "description": "Tool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_messaging_url_domains",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/messaging/url/domains",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "messaging",
            "url",
            "domains"
          ]
        },
        "description": "Tool to list configured messaging URL domains. Use when you need to retrieve messaging URL domains for a profile.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"filter_profile_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_mobile_network_operators",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/mobile/network/operators",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "mobile",
            "network",
            "operators"
          ]
        },
        "description": "Tool to list available mobile network operators. Use when you need to discover operators optionally filtered by country code, operator name, or with pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"country_code\": \"\",\n  \"operator_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_network_interfaces",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/network/interfaces",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "network",
            "interfaces"
          ]
        },
        "description": "Tool to list all network interfaces for a specified network. Use after retrieving a network's ID to enumerate its interfaces.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"network_id\": \"\",\n  \"filter_name\": \"\",\n  \"filter_type\": \"\",\n  \"page_number\": 0,\n  \"filter_status\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_networks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/networks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "networks"
          ]
        },
        "description": "Tool to list all networks in your account. Use when you need to retrieve networks with optional pagination and filtering.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"filter_name\": \"\",\n  \"page_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_notification_channels",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notification/channels",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notification",
            "channels"
          ]
        },
        "description": "Tool to list all notification channels. Use when you need to retrieve and paginate existing notification channels, optionally filtering by channel type.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"filter_channel_type_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_notification_event_conditions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notification/event/conditions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notification",
            "event",
            "conditions"
          ]
        },
        "description": "Tool to list all notification event conditions. Use when you need to retrieve and paginate notification event conditions, optionally filtering by associated record type.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"filter_associated_record_type_eq\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_notification_events",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notification/events",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notification",
            "events"
          ]
        },
        "description": "Tool to list all notification events with their IDs. Use to dynamically retrieve notification_event_condition_id values before configuring webhook subscriptions — IDs are account-specific and must not",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_notification_profiles",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notification/profiles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notification",
            "profiles"
          ]
        },
        "description": "Tool to list all notification profiles. Use when you need to retrieve and paginate your notification profiles with optional pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page_size\": 0,\n  \"page_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_phone_numbers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/phone/numbers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "phone",
            "numbers"
          ]
        },
        "description": "Tool to list phone numbers associated with your account. Use when you need to retrieve and filter your phone numbers with optional pagination and sorting.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"page_size\": 0,\n  \"page_number\": 0,\n  \"filter_status\": \"\",\n  \"filter_phone_number\": \"\",\n  \"filter_connection_id\": \"\",\n  \"filter_national_destination_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_list_sso_authentication_providers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/sso/authentication/providers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "sso",
            "authentication",
            "providers"
          ]
        },
        "description": "Tool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"page_size\": 0,\n  \"page_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_retrieve_network",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/network",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "network"
          ]
        },
        "description": "Tool to retrieve details of a specific network by ID. Use after obtaining the network's identifier to fetch its current attributes before update or delete operations.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"network_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_retrieve_notification_channel",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/notification/channel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "notification",
            "channel"
          ]
        },
        "description": "Tool to retrieve a notification channel by ID. Use after you have a channel ID and need its details, such as name, type, and status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_retrieve_notification_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/notification/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "notification",
            "profile"
          ]
        },
        "description": "Tool to retrieve a notification profile by ID. Use after obtaining the profile ID when you need details about its webhook endpoints and subscribed events.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_retrieve_notification_setting",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/notification/setting",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "notification",
            "setting"
          ]
        },
        "description": "Tool to retrieve a notification setting by ID. Use after obtaining the notification setting ID to fetch its details, such as status, parameters, and associated channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "telnyx_update_network",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/network",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "network"
          ]
        },
        "description": "Tool to update details of an existing network. Use when you have a network's identifier and need to modify its name or tags.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"tags\": \"\",\n  \"network_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}