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/mcpor/mcp/sse. - An assistant that supports remote MCP servers, such as the ones below.
| SETTING | VALUE |
|---|---|
| Server URL | https://mcp.trendly.com.sa |
| Transport | Streamable HTTP, at the root URL |
| Sign-in | OAuth 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
Step 1: Open Settings, then Connectors
In Claude, open Settings and go to Connectors.
Step 2: Add a custom connector
Choose Add custom connector. Name it
Trendlyand paste the URLhttps://mcp.trendly.com.sa. Choose Add.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.
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
CHATGPT
ChatGPT
Step 1: Turn on Developer mode
Open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode.
Step 2: Create the connector
Back in Apps & Connectors, choose Create. Name it
Trendly, set the MCP server URL tohttps://mcp.trendly.com.saand set Authentication to OAuth. Choose Create.Step 3: Sign in
A Trendly sign-in page opens. Sign in with your Trendly email and password.
Step 4: Use it in a chat
Start a new chat, pick Trendly from the tools menu and ask away.
No Developer mode?
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.
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 trendlyThe second command opens the Trendly sign-in page in your browser. Sign in with your Trendly email and password.
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, pastehttps://mcp.trendly.com.saand 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
Step 1: Add the server
In a terminal:
Terminal
claude mcp add --transport http trendly https://mcp.trendly.com.saStep 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
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.jsonin the repo.~/.cursor/mcp.json
{ "mcpServers": { "trendly": { "url": "https://mcp.trendly.com.sa" } } }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
Step 1: Add the server
Create
.vscode/mcp.jsonin your workspace:.vscode/mcp.json
{ "servers": { "trendly": { "type": "http", "url": "https://mcp.trendly.com.sa" } } }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.
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
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.
| AREA | WHAT THE ASSISTANT CAN DO |
|---|---|
| Campaigns | Create and update campaigns, complete or reactivate them, set deliverables, add photos. |
| Offers | List offers on a campaign, approve, reject or counter them, one at a time or in bulk, and read their history. |
| Creators | Search creators by country, city, category, followers and engagement. Read profiles, analytics and audience demographics. |
| Lists and shortlists | Build influencer lists and campaign shortlists, and add or remove creators. |
| Collaborations | Follow collaborations, review content submissions, approve content or ask for changes, see published posts. |
| Briefs | Write campaign and collaboration briefs and share them with creators. |
| Messages | Read and send messages, open conversations, and message many creators at once. |
| Payments | Get quotes and create payment links to hire creators. |
| Ad codes and paid ads | Set and check ad codes, and run paid ads on creators' posts when that is enabled for your account. |
| Analytics | Dashboard overview, campaign analytics and reports, and comparisons between campaigns. |
| Notifications | Read notifications and mark them read. |
| Agencies | Manage 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 SEE | WHAT TO DO |
|---|---|
| Sign-in says the account is under review | Your Trendly account is not activated yet. Contact Trendly to have it activated, then connect again. |
| Connected, but the assistant has no Trendly tools | Turn 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 connecting | Allow 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 again | The session ended, usually because your Trendly password changed. Connect or authenticate again. |
| Cannot connect from the office network | Desktop 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/sse | That 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