What an agent can do in Semrush
Research keywords, competitors and traffic with Semrush's SEO and Trends data, and read your projects. Read only; uses your Semrush API units.
Jobs on Rush that use Semrush
- Compare Competitor Traffic With Semrush
- Write an SEO Content Brief With Semrush Data
- Run a Keyword Gap Analysis With Semrush
- Run an SEO Audit on a Starlight Site
How Semrush connects
Semrush is a remote MCP server, published by Semrush, at https://mcp.semrush.com/v2/mcp. Connecting it signs in through the MCP OAuth flow on Semrush's side.
From Semrush: Semrush's MCP documentation.
Connect it once in the console under Settings → Connections, or from your server with POST /me/connections. The sign-in finishes in a browser signed in to the console as the same person, and a link not finished within 10 minutes expires.
After that, a run that names semrush in connections, or runs a saved agent that names it, gets it; your connections reach no run that does not name them.
POST https://api.phoenix.so/me/connections
{
"type": "mcp",
"name": "Semrush",
"url": "https://mcp.semrush.com/v2/mcp"
}Whose Semrush account the agent uses
Your Semrush connection is personal: it belongs to the person who signed in. A run started in the console uses that person's Semrush, and a run started with an API key uses the Semrush of the member who created the key.
To act for your own app's users, make each user an agent from your template and show them, signed in to your app, the sign-in link POST /o/{org}/agents/{agent}/connections returns. They sign in to their own Semrush, and that agent's runs use their account and nothing else: never yours, never another user's.
More Marketing integrations
Frequently asked questions
How do I connect Semrush to Rush?
Open Settings → Connections in the console and connect Semrush, or send POST /me/connections with {"type":"mcp","name":"Semrush","url":"https://mcp.semrush.com/v2/mcp"} and open the authorize_url it returns while signed in to the console. The connection reads pending until the sign-in finishes, then connected.
Does every run get my Semrush account?
No. A run gets your Semrush connection only when it names it in connections ("connections": ["semrush"]), or runs a saved agent that names it. A saved agent names its connections once, and every run of it gets them.
What can an agent do in Semrush?
Research keywords, competitors and traffic with Semrush's SEO and Trends data, and read your projects. Read only; uses your Semrush API units. 4 published jobs use it; this page lists them.
Can my app's users connect their own Semrush?
Yes. Make each user an agent from your template, and they sign in to their own Semrush through the link POST /o/{org}/agents/{agent}/connections returns. That agent's runs use their account alone.
Keep reading
- AI agents for marketing teams: every job and app for them
- How connections work: sign in once, then every run that names a connection gets it
- Start your first run from the developer API quickstart
- Pricing: one price per member, hours shared by the team
- How Rush compares with other cloud agents
- Every app and MCP server Rush connects to