TrendGuru MCP server
A remote MCP server that lets your AI assistant publish to social media. Add one URL to Claude, ChatGPT, Claude Code or Cursor, and the assistant can see your connected accounts, check a post against each network's rules, publish or schedule it, and read analytics and trends.
Get a free keyMCP in the API reference
What the assistant can do
The server gives the assistant 14 tools. Each one goes through the same services as the dashboard and the REST API.
Accounts
- list_accounts
- Connected social accounts with ids, platforms, usernames, follower counts and whether one needs reconnecting.
- list_profiles
- Profiles that group accounts by brand or client.
Posts
- validate_post
- Checks a post against every network's rules (length, media type and count, required title) without creating anything.
- create_post
- Publishes now, schedules for a time or saves a draft to the accounts you name, with text and options per account.
- list_posts
- Recent posts with the status and link for each account.
- get_post
- One post with the status, link and error of every account it goes to.
- retry_post
- Sends a post again only to the accounts where it failed.
- delete_post
- Deletes a draft or scheduled post from TrendGuru. Copies already published stay on the networks.
Analytics
- get_account_analytics
- Followers and their change, posts, engagement compared with the previous period, and platform statistics where the network provides them.
- get_top_posts
- Best performing posts of the connected accounts, including ones not made through TrendGuru.
Credits
- get_usage
- The plan, credits left, what a post costs and profile limits.
Trends (paid plans)
- list_trend_niches
- The niches your workspace watches in Trend radar.
- list_trends
- TikTok videos and YouTube Shorts from small accounts that suddenly got far more views than usual, by niche.
- list_trend_sounds
- Sounds behind the trending videos of the last 24 to 72 hours.
Things to ask
- Post this video to TikTok and YouTube at 6 pm.
- What took off in my niche today?
- Which post did best this week, and why?
How to connect
The endpoint is https://trend.guru/api/mcp (Streamable HTTP). Claude and ChatGPT sign in with OAuth, so there is no key to paste. Other clients send a TrendGuru API key as a Bearer token.
Claude and ChatGPT (connector with OAuth)
- Open the connector settings in Claude or ChatGPT and add a custom connector.
- Paste the server URL.
- Sign in to TrendGuru, pick a workspace and allow access.
Server URL
https://trend.guru/api/mcp
Disconnect any time in the dashboard under API keys → Connected apps.
Claude Code
Create a key in the dashboard under API keys, then run:
claude mcp add --transport http trendguru https://trend.guru/api/mcp \ --header "Authorization: Bearer tg_live_..."
Cursor and any client with a config file
Add the server to the client's mcp.json:
{
"mcpServers": {
"trendguru": {
"url": "https://trend.guru/api/mcp",
"headers": { "Authorization": "Bearer tg_live_..." }
}
}
}Give the assistant a key with only the scopes it needs. A read-only key lets it look but not publish.
Networks it publishes to
The assistant publishes to the accounts you connected in the dashboard, each through the network's own sign-in.
- Feed images, carousels (up to 10), Reels and Stories.
- TikTok
- Video posts and photo carousels (up to 35), with privacy level and comment, duet and stitch toggles.
- YouTube
- Video upload with title, description, tags, visibility and playlist.
- Facebook Pages
- Text and links, photos, video, Reels and Stories.
- Personal profile posts with images, video, PDF documents and polls.
- X (paid plans)
- Tweets with up to 4 images or one video, threads and polls. 10 credits per tweet, 100 with a link.
A text-only post works on Facebook, LinkedIn and X. Instagram and TikTok need media and YouTube needs a video; validate_post tells the assistant before anything is sent.
Permissions and review
The assistant never gets more access than the person or the key behind it.
- Workspace and role
- An OAuth connection acts with the rights of the signed-in user in the workspace they picked. A team member's channels and limits apply.
- Review
- If a channel is set to review for that member, the post waits in status review until someone with publish rights approves it.
- Scopes
- With an API key every tool checks the key's scopes, and write tools refuse a read-only key.
- Tokens
- OAuth uses PKCE. Access tokens live one hour and work only on the MCP endpoint; refresh tokens rotate on every use.
- Credits
- Posts made through MCP cost the same credits as posts from the dashboard or the API.
- Limits
- One create_post call takes up to 25 accounts and 35 media URLs. The trend tools need a paid plan.
Pricing: pay per post
1 credit = $0.01 = one post to one network. A post sent to five networks costs 5 credits. The Free plan gives 50 credits every month, no card needed.
The MCP server is included in every plan, Free too. You pay only for what the assistant publishes.
| Plan | Price | Credits per month |
|---|---|---|
| Free | $0 per month | 50 |
| Creator | $9 per month | 500 |
| Pro | $29 per month | 2,000 |
| Business | $99 per month | 7,500 |
Credit packs are one-time purchases on any plan and never expire: 1,000 credits for $10, 5,000 credits for $50, 25,000 credits for $250. Plan credits renew every month and the unused part expires; plan credits are spent first.
On X a tweet costs 10 credits, or 100 with a link, because X bills every write; X is open on paid plans. Credits are taken when a post is sent and come back if it finally fails.
Questions
What is the TrendGuru MCP server?
It is a remote Model Context Protocol server at https://trend.guru/api/mcp. An AI assistant connected to it can publish and schedule posts to your social accounts and read analytics and trends, using 14 tools.
Which assistants work with it?
Claude and ChatGPT through a connector with OAuth, Claude Code and Cursor with an API key, and any other MCP client that supports Streamable HTTP.
Do I need an API key?
Not for Claude or ChatGPT: the connector signs in with OAuth. Claude Code, Cursor and other clients send a TrendGuru API key as a Bearer token; create one in the dashboard under API keys.
Can the assistant publish without asking me?
It can do what your account can do. To keep a person in the loop, ask it for drafts (create_post without a time saves a draft), give it a read-only key or, in a team, set the member's channels to review so every post waits for approval.
How much does it cost?
The MCP server costs nothing extra. A post to one network costs 1 credit ($0.01), the Free plan includes 50 credits a month and paid plans start at $9 a month.
Can it post to X?
Yes, on paid plans. A tweet costs 10 credits, or 100 with a link.
How do I disconnect an assistant?
Open API keys → Connected apps in the dashboard and disconnect it, or delete the API key the client uses.
Connect your assistant
Sign up, connect a social account and add the server URL. The first 50 credits every month are free.
Publishing APIAPI referenceOpenAPI fileFull FAQllms.txtTrendGuru