{
  "info": {
    "name": "Toneden — mcp.ai",
    "description": "REST API for the Toneden 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/toneden",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "toneden_create_advertising_campaign",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/advertising/campaign",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "advertising",
            "campaign"
          ]
        },
        "description": "Tool to create a ToneDen advertising campaign on Facebook or Google platforms. Use when you need to launch a new ad campaign with specified budget, targeting, and creatives.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"status\": \"\",\n  \"target\": \"\",\n  \"currency\": \"\",\n  \"platform\": \"\",\n  \"audiences\": \"\",\n  \"creatives\": {},\n  \"objective\": \"\",\n  \"targeting\": {},\n  \"budget_type\": \"\",\n  \"target_type\": \"\",\n  \"budget_amount\": 0,\n  \"end_timestamp\": 0,\n  \"is_continuous\": false,\n  \"report_emails\": \"\",\n  \"optimization_id\": \"\",\n  \"start_timestamp\": 0,\n  \"target_link_url\": \"\",\n  \"external_poster_id\": \"\",\n  \"instagram_account_id\": \"\",\n  \"external_ad_account_id\": \"\",\n  \"disable_all_notifications\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_create_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "attachment"
          ]
        },
        "description": "Tool to create an attachment. Use when you need to programmatically create a social unlock or contest attachment after gathering all required parameters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"platform\": \"\",\n  \"platforms\": \"\",\n  \"unlock_text\": \"\",\n  \"unlock_type\": \"\",\n  \"download_url\": \"\",\n  \"messenger_page_id\": \"\",\n  \"stream_unlock_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_create_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "link"
          ]
        },
        "description": "Tool to create a ToneDen link. Use when you have the target_type and, if needed, the services array. Supports creation of links for music, podcast, livestream, event, tour, biglink, fundraiser, smartl",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"services\": \"\",\n  \"target_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_delete_advertising_campaign",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/advertising/campaign",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "advertising",
            "campaign"
          ]
        },
        "description": "Deletes a ToneDen advertising campaign by ID using DELETE /advertising/campaigns/{campaignID}.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"campaignID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_delete_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "link"
          ]
        },
        "description": "Deletes a ToneDen link by ID using DELETE /links/{linkID}.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"link_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_delete_playbook_campaign",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/playbook/campaign",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "playbook",
            "campaign"
          ]
        },
        "description": "Deletes a ToneDen playbook campaign by ID using DELETE /playbooks/campaigns/{campaignID}.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"campaign_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_expand_link_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/expand/link/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "expand",
            "link",
            "template"
          ]
        },
        "description": "Tool to expand a ToneDen link template. Use when you need to retrieve the full template link with your tracking pixels and optional service links. Provide a URL to generate platform services for music",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_advertising_campaign",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/advertising/campaign",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "advertising",
            "campaign"
          ]
        },
        "description": "Retrieve a specific advertising campaign by its ID using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID} Notes: - This endpoint does not require a userID in the path per official docs",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"campaignID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_advertising_campaign_creative_insights",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/advertising/campaign/creative/insights",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "advertising",
            "campaign",
            "creative",
            "insights"
          ]
        },
        "description": "Retrieve creative performance insights for a specific advertising campaign using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID}/creativeInsights. Note: Endpoint uses camelCase `creat",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"campaignID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_advertising_campaign_insights",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/advertising/campaign/insights",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "advertising",
            "campaign",
            "insights"
          ]
        },
        "description": "Retrieve performance insights for a specific advertising campaign using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID}/insights.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"campaignID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "attachment"
          ]
        },
        "description": "Tool to retrieve an attachment by ID. Use when you need to fetch details of an existing attachment by its ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"attachmentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_attachment_entries_time_series",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/attachment/entries/time/series",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "attachment",
            "entries",
            "time",
            "series"
          ]
        },
        "description": "Tool to fetch time-series entry statistics for a specific attachment. Use when you need chronological entry data points for an attachment.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"attachmentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_attachment_entries_totals",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/attachment/entries/totals",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "attachment",
            "entries",
            "totals"
          ]
        },
        "description": "Tool to fetch summary counts of entries for an attachment. Use when you need aggregate entry counts over day, week, month, and lifetime.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"attachmentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_attachment_unlocks_by_platform",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/attachment/unlocks/by/platform",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "attachment",
            "unlocks",
            "by",
            "platform"
          ]
        },
        "description": "Tool to fetch counts of unlocks by platform for a specific attachment. Use when you need a breakdown of unlocks across platforms like Spotify, Twitter, etc.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"attachmentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_attachment_unlocks_time_series",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/attachment/unlocks/time/series",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "attachment",
            "unlocks",
            "time",
            "series"
          ]
        },
        "description": "Tool to fetch time-series unlock statistics for a specific attachment. Use when you need chronological unlock data points for an attachment.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"attachmentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_link",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/link",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "link"
          ]
        },
        "description": "Tool to retrieve a specific ToneDen link by its ID. Use when you need to fetch details about an existing link.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"linkID\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_link_insights",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/link/insights",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "link",
            "insights"
          ]
        },
        "description": "Tool to retrieve detailed insights for a ToneDen link. Use when you have a link ID and need metrics such as clicks, clickthroughs, email clicks, etc.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"linkID\": \"\",\n  \"metric\": \"\",\n  \"end_date\": \"\",\n  \"start_date\": \"\",\n  \"aggregate_geo\": \"\",\n  \"for_distinct_fans\": false,\n  \"aggregate_interval\": \"\",\n  \"aggregate_by_service\": false,\n  \"aggregate_by_referrer\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_link_insights_overview",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/link/insights/overview",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "link",
            "insights",
            "overview"
          ]
        },
        "description": "Tool to retrieve a summary overview of a link's performance insights. Use when you have a link ID and need aggregated metrics across platforms.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"linkID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_get_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user"
          ]
        },
        "description": "Tool to retrieve a specific ToneDen user by ID. Use when you need to fetch user profile information or details about the currently authenticated user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_list_playbook_campaigns",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/playbook/campaigns",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "playbook",
            "campaigns"
          ]
        },
        "description": "Tool to list playbook campaigns. Use when you need to retrieve a paginated list of all playbook campaigns.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_list_user_attachments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/user/attachments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "user",
            "attachments"
          ]
        },
        "description": "Tool to list attachments for a user. Use when you need to retrieve social unlocks or contest attachments belonging to a specific user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"limit\": 0,\n  \"offset\": 0,\n  \"userID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_list_user_lists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/user/lists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "user",
            "lists"
          ]
        },
        "description": "Tool to retrieve a list of a user's advertising user lists. Use when you need to fetch all user lists (custom audiences) for a specific ToneDen user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"userID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_update_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "attachment"
          ]
        },
        "description": "Tool to update an existing attachment. Use when you need to flexibly modify any attachment field (or add custom fields) after its creation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"update\": {},\n  \"platform\": \"\",\n  \"link_path\": \"\",\n  \"platforms\": \"\",\n  \"unlock_text\": \"\",\n  \"unlock_type\": \"\",\n  \"attachmentID\": \"\",\n  \"download_url\": \"\",\n  \"messenger_page_id\": \"\",\n  \"stream_unlock_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_update_playbook_campaign",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/playbook/campaign",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "playbook",
            "campaign"
          ]
        },
        "description": "Updates a ToneDen playbook campaign by ID using PUT /playbooks/campaigns/{campaignID}. Note: ToneDen's public docs do not expose the full request body schema for updates. This action sends a flexible ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"notes\": \"\",\n  \"budget\": 0,\n  \"status\": \"\",\n  \"update\": {},\n  \"end_date\": \"\",\n  \"metadata\": {},\n  \"start_date\": \"\",\n  \"campaign_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_update_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "user"
          ]
        },
        "description": "Tool to update a ToneDen user's profile. Use when you need to modify user details (e.g., name, location, or settings) after fetching them.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"about\": \"\",\n  \"state\": \"\",\n  \"policy\": \"\",\n  \"country\": \"\",\n  \"user_id\": \"\",\n  \"profile_url\": \"\",\n  \"display_name\": \"\",\n  \"timezone_name\": \"\",\n  \"additional_emails\": \"\",\n  \"interface_settings\": {},\n  \"advertising_settings\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "toneden_validate_link_path",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/link/path",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "link",
            "path"
          ]
        },
        "description": "Tool to check if a link path/subdomain combination is unique and valid. Use when creating or editing a ToneDen link to verify the path is available.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"path\": \"\",\n  \"link_id\": 0,\n  \"subdomain\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}