Developers
MCP connector

Connect Trendly to your AI assistant

Trendly runs an MCP server. Add it to Claude, ChatGPT, Codex, Claude Code, Cursor or VS Code, sign in with your Trendly email and password, and the assistant can search creators, run campaigns and handle offers for you, with the same access you have in the dashboard.

SERVER URL

https://mcp.trendly.com.sa

OVERVIEW

Before you start

You need three things.

  • An activated Trendly account. Brand and agency accounts both work. An account that is still under review cannot sign in yet.
  • The server URL: https://mcp.trendly.com.sa. The endpoint is the root URL itself, not /mcp or /mcp/sse.
  • An assistant that supports remote MCP servers, such as the ones below.
SETTINGVALUE
Server URLhttps://mcp.trendly.com.sa
TransportStreamable HTTP, at the root URL
Sign-inOAuth 2.1 with dynamic client registration and PKCE. Your assistant registers itself; there is no client id or secret to copy.

Signing in works the same way everywhere. The assistant opens a Trendly sign-in page, you sign in with your Trendly email and password, and you are sent back. That is the whole setup. The assistant never sees your password.

CLAUDE

Claude on the web, desktop and mobile

  1. Step 1: Open Settings, then Connectors

    In Claude, open Settings and go to Connectors.

  2. Step 2: Add a custom connector

    Choose Add custom connector. Name it Trendly and paste the URL https://mcp.trendly.com.sa. Choose Add.

  3. Step 3: Connect and sign in

    Choose Connect next to Trendly. A Trendly sign-in page opens. Sign in with your Trendly email and password.

  4. Step 4: Turn it on in a chat

    In a conversation, open the tools menu and switch Trendly on. Then ask for something, for example "Show my active campaigns".

Claude Team or Enterprise

An organisation owner may need to add the connector for the organisation first. After that, each person connects and signs in with their own Trendly account.

CHATGPT

ChatGPT

  1. Step 1: Turn on Developer mode

    Open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode.

  2. Step 2: Create the connector

    Back in Apps & Connectors, choose Create. Name it Trendly, set the MCP server URL to https://mcp.trendly.com.sa and set Authentication to OAuth. Choose Create.

  3. Step 3: Sign in

    A Trendly sign-in page opens. Sign in with your Trendly email and password.

  4. Step 4: Use it in a chat

    Start a new chat, pick Trendly from the tools menu and ask away.

No Developer mode?

Custom connectors are only available on some ChatGPT plans. If you do not see Developer mode, your workspace admin has to allow it.

CODEX

Codex

The Codex CLI, the IDE extension and the Codex app share one configuration, so adding Trendly once makes it available in all three.

  1. Step 1: Add the server and sign in

    In a terminal:

    Terminal

    codex mcp add trendly --url https://mcp.trendly.com.sa
    codex mcp login trendly

    The second command opens the Trendly sign-in page in your browser. Sign in with your Trendly email and password.

  2. Step 2: Or add it in the app

    In the Codex app or the IDE extension, open Settings, then MCP servers, and choose Add server. Name it trendly, choose Streamable HTTP, paste https://mcp.trendly.com.sa and save. Restart when asked, then choose Authenticate.

Either way the server ends up in ~/.codex/config.toml:

~/.codex/config.toml

[mcp_servers.trendly]
url = "https://mcp.trendly.com.sa"

CLAUDE CODE

Claude Code

  1. Step 1: Add the server

    In a terminal:

    Terminal

    claude mcp add --transport http trendly https://mcp.trendly.com.sa
  2. Step 2: Authenticate

    Start Claude Code, run /mcp, pick trendly and choose Authenticate. Your browser opens the Trendly sign-in page.

By default the server is added for the current project only. Add --scope user to the command to have it in every project.

CURSOR

Cursor

  1. Step 1: Add the server

    Add this to ~/.cursor/mcp.json (create the file if it does not exist). To share it with a project instead, put it in .cursor/mcp.json in the repo.

    ~/.cursor/mcp.json

    {
      "mcpServers": {
        "trendly": {
          "url": "https://mcp.trendly.com.sa"
        }
      }
    }
  2. Step 2: Sign in

    Open Customize in Cursor's sidebar (in older versions, Cursor Settings, then MCP) and choose Connect or Login next to trendly. Sign in on the page that opens.

VS CODE

VS Code with GitHub Copilot

  1. Step 1: Add the server

    Create .vscode/mcp.json in your workspace:

    .vscode/mcp.json

    {
      "servers": {
        "trendly": {
          "type": "http",
          "url": "https://mcp.trendly.com.sa"
        }
      }
    }
  2. Step 2: Start it and sign in

    Choose Start above the server in that file. VS Code asks you to sign in, and opens the Trendly sign-in page.

  3. Step 3: Use it in agent mode

    Open Copilot Chat, switch to Agent, and the Trendly tools are available.

OTHER CLIENTS

Any other MCP client

Point the client at https://mcp.trendly.com.sa over Streamable HTTP and let it sign in with OAuth. A client that supports OAuth discovery and dynamic registration needs nothing else.

Clients without OAuth

For a client that can only send a fixed header, there is a legacy bearer token. Ask for one with your Trendly email and password:

Get a token

curl -X POST https://mcp.trendly.com.sa/mcp-token \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "password": "YOUR_TRENDLY_PASSWORD" }'

The token field of the response is the bearer token. Send it on every request as Authorization: Bearer <token>, for example:

Client config

{
  "mcpServers": {
    "trendly": {
      "url": "https://mcp.trendly.com.sa",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Treat the token like a password

It is your Trendly session token. It lasts 90 days and gives the same access as signing in to the dashboard. Keep it out of source control, and clear the command above from your shell history, since it contains your password. Changing your Trendly password ends the token early. Use OAuth wherever the client supports it.

TOOLS

What it can do

About 125 tools for brands and agencies, covering most of what you do in the dashboard. The assistant picks the tools; you ask in plain words.

AREAWHAT THE ASSISTANT CAN DO
CampaignsCreate and update campaigns, complete or reactivate them, set deliverables, add photos.
OffersList offers on a campaign, approve, reject or counter them, one at a time or in bulk, and read their history.
CreatorsSearch creators by country, city, category, followers and engagement. Read profiles, analytics and audience demographics.
Lists and shortlistsBuild influencer lists and campaign shortlists, and add or remove creators.
CollaborationsFollow collaborations, review content submissions, approve content or ask for changes, see published posts.
BriefsWrite campaign and collaboration briefs and share them with creators.
MessagesRead and send messages, open conversations, and message many creators at once.
PaymentsGet quotes and create payment links to hire creators.
Ad codes and paid adsSet and check ad codes, and run paid ads on creators' posts when that is enabled for your account.
AnalyticsDashboard overview, campaign analytics and reports, and comparisons between campaigns.
NotificationsRead notifications and mark them read.
AgenciesManage the brands and creators on an agency roster.

Affiliate sales are not reported through MCP. For those, use the Sales API.

EXAMPLES

Things to ask

Start with something like these, and change the names and numbers to yours.

Find 20 Saudi beauty creators under 100k followers with engagement above 3% and add them to a list called Ramadan shortlist.

Which offers on my Ramadan campaign are still waiting, and who is cheapest per view?

Counter every offer above 5,000 SAR on my summer campaign at 4,000 SAR.

Show the audience demographics for the five creators on my Ramadan shortlist. What share of each audience is in Riyadh?

Which content submissions are waiting for my approval? Summarise each one.

Share the Eid brief with everyone I approved on the Eid campaign and ask them to confirm their posting date.

Compare my last two campaigns on views, engagement and cost per view.

Create a payment link for the three creators I approved yesterday.

The more specific the ask, the fewer questions the assistant comes back with.

SECURITY

What it can reach, and how to stop it

  • It acts as you. The assistant works as the signed-in user, with the same permissions as your dashboard. It cannot see other brands' data, and an agency sees the brands it manages.
  • Its actions are real. Approving an offer, sending a message or creating a payment link reaches real creators. Most assistants ask before running a tool that changes something. Read what it is about to do before you allow it.
  • To disconnect, remove the Trendly connector in your assistant. That stops it at once.
  • To end every session, change your Trendly password. Every connected assistant, and every legacy token, has to sign in again.

TROUBLESHOOTING

When it does not work

WHAT YOU SEEWHAT TO DO
Sign-in says the account is under reviewYour Trendly account is not activated yet. Contact Trendly to have it activated, then connect again.
Connected, but the assistant has no Trendly toolsTurn the connector on for that conversation from the tools menu. Some assistants start every new chat with custom connectors off.
The sign-in page does not open, or closes without connectingAllow pop-ups for the assistant and try again. Sign in with the email you use for the Trendly dashboard.
It worked, then asks you to sign in againThe session ended, usually because your Trendly password changed. Connect or authenticate again.
Cannot connect from the office networkDesktop clients (Codex, Claude Code, Cursor, VS Code) connect from your machine, so it must reach https://mcp.trendly.com.sa on port 443, and a proxy must pass streamed responses through without buffering them. Ask IT to allow the host. Claude and ChatGPT on the web connect from their own servers, so office proxies do not affect them.
An old guide says /mcp/sseThat address is out of date. Use the root URL, https://mcp.trendly.com.sa.

Set it up from the dashboard

The AI assistants page in your Trendly dashboard has the server URL and these steps next to your account.

Open in your dashboard