Connect your AI Agents to Strava in minutes
Available tools
create_activity
Create a manual activity. Requires name, type (Run, Ride, Swim, etc.), start_date_local (ISO 8601), and elapsed_time (seconds).
get_activity
Get an activity by ID. Returns detailed activity data including stats, map, and segment efforts.
update_activity
Update an activity. Can change name, type, description, trainer, commute, and gear_id. Set gear_id to 'none' to remove gear.
list_athlete_activities
List the authenticated athlete's activities with pagination. Filter by before/after epoch timestamps. Use page and per_page for pagination.
list_activity_comments
List comments on an activity. Use page and per_page for pagination.
list_activity_kudoers
List athletes who gave kudos on an activity. Use page and per_page for pagination.
get_activity_laps
Get laps for an activity. Returns lap splits with time, distance, and pace data.
get_authenticated_athlete
Get the authenticated athlete's profile. Returns detailed info including name, location, stats, and gear.
update_athlete
Update the authenticated athlete's profile. Currently only weight can be updated.
get_athlete_zones
Get the authenticated athlete's heart rate and power zones.
get_athlete_stats
Get an athlete's activity stats (totals, recent, year-to-date). Use get_authenticated_athlete to find the athlete ID.
get_club
Get a club by ID. Returns club details including name, location, member count, and sport type.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Strava MCP server
FAQs on using Merge's Strava MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
