Polarsteps MCP tools

MCP tool polarsteps_list_trips

Returns the trips on your own account, newest first. Filter by status to see only planned, ongoing or past trips. Use trip_id from each item in the other endpoints.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_list_trips",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trips": [
      {
        "trip_id": "18452237",
        "name": "Portugal by train",
        "start_date": "2026-10-01",
        "end_date": null,
        "privacy": "followers",
        "steps": 9,
        "distance_km": 612
      },
      {
        "trip_id": "16720458",
        "name": "Patagonia",
        "start_date": "2025-12-04",
        "end_date": "2026-01-19",
        "privacy": "everyone",
        "steps": 41,
        "distance_km": 3870
      }
    ]
  },
  "isError": false
}

MCP tool polarsteps_get_trip

Returns one trip with its summary, start and end dates, privacy level and the Travel Buddies on it. Trip dates are separate from the dates of its steps.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_get_trip",
    "arguments": {
      "trip_id": "trip_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "18452237",
    "name": "Portugal by train",
    "summary": "Two weeks from Porto to Faro on regional trains.",
    "start_date": "2026-10-01",
    "end_date": null,
    "privacy": "followers",
    "travel_buddies": [
      "Marta Silva"
    ],
    "distance_km": 612,
    "countries": [
      "Portugal"
    ]
  },
  "isError": false
}

MCP tool polarsteps_list_steps

Lists the steps of one trip in the order of the trip. Story is a short preview; get_step returns the full text, coordinates and photo links. Pass since to see only steps from a given date.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_list_steps",
    "arguments": {
      "trip_id": "trip_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "steps": [
      {
        "step_id": "231908554",
        "title": "Fado night in Alfama",
        "place": "Lisbon",
        "country": "Portugal",
        "date": "2026-10-09T19:30:00+01:00",
        "photos": 2,
        "comments": 1
      },
      {
        "step_id": "231544107",
        "title": "Tram 28 to Graça",
        "place": "Lisbon",
        "country": "Portugal",
        "date": "2026-10-09T11:10:00+01:00",
        "photos": 3,
        "comments": 0
      }
    ]
  },
  "isError": false
}

MCP tool polarsteps_get_step

Returns one step with its full story, the place and its coordinates, the date and time, and links to every photo and video. Use it before editing a step or turning it into a post.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_get_step",
    "arguments": {
      "step_id": "231908554"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "step_id": "231908554",
    "trip_id": "18452237",
    "title": "Fado night in Alfama",
    "story": "Got lost in the old town, then found a tiny fado bar with six tables.",
    "place": "Alfama, Lisbon, Portugal",
    "coordinates": {
      "lat": 38.711,
      "lon": -9.1304
    },
    "date": "2026-10-09T19:30:00+01:00",
    "media": [
      "https://example.com/photos/alfama-1.jpg",
      "https://example.com/photos/alfama-2.jpg"
    ]
  },
  "isError": false
}

MCP tool polarsteps_list_step_comments

Returns the comments on one step, oldest first, with author and date. Replies from you are included under the comment they answer. Use comment_id with reply_to_step_comment.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_list_step_comments",
    "arguments": {
      "step_id": "step_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "comments": [
      {
        "comment_id": "cm_4821",
        "author": "Eva Novak",
        "body": "That fado bar looks amazing!",
        "created_at": "2026-10-09T21:05:00+01:00",
        "replies": []
      }
    ]
  },
  "isError": false
}

MCP tool polarsteps_get_travel_stats

Returns the figures from the Travel stats on your profile: countries visited, kilometers, trips and steps. Countries are counted from the steps you add.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_get_travel_stats",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "countries": 14,
    "distance_km": 28640,
    "trips": 6,
    "steps": 187
  },
  "isError": false
}

MCP tool polarsteps_export_trip

Exports one trip as json, gpx or markdown and returns a download link valid for 1 hour. gpx holds the route, markdown holds the step stories. Set include_media for a zip of the full-size photos and videos. It only reads, so it never asks for your OK.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_export_trip",
    "arguments": {
      "trip_id": "16720458",
      "format": "gpx",
      "include_media": false
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "16720458",
    "format": "gpx",
    "download_url": "https://example.com/exports/16720458.gpx",
    "expires_at": "2026-10-11T15:00:00+02:00",
    "steps": 41
  },
  "isError": false
}

MCP tool polarsteps_create_trip

Creates a trip with a name and start date. The start date can be in the past, for a trip from before you used Polarsteps. Privacy is Only me (only_me) unless you set followers or everyone, so nothing is shared by accident. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_create_trip",
    "arguments": {
      "name": "Jane Doe",
      "start_date": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "20931176",
    "name": "Vietnam 2019",
    "start_date": "2019-03-02",
    "end_date": "2019-03-20",
    "privacy": "only_me",
    "steps": 0
  },
  "isError": false
}

MCP tool polarsteps_add_step

Adds one step to a trip at a place and time, with an optional title, story and photos by URL. The date and place set where the step sits on the route. Everyone who can see the trip, by its privacy level, sees the step. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_add_step",
    "arguments": {
      "trip_id": "18452237",
      "place": "Alfama, Lisbon, Portugal",
      "date": "2026-10-09T19:30:00+01:00",
      "title": "Fado night in Alfama",
      "story": "Got lost in the old town, then found a tiny fado bar with six tables.",
      "photo_urls": [
        "https://example.com/photos/alfama-1.jpg",
        "https://example.com/photos/alfama-2.jpg"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "step_id": "231908554",
    "trip_id": "18452237",
    "title": "Fado night in Alfama",
    "place": "Lisbon, Portugal",
    "date": "2026-10-09T19:30:00+01:00",
    "photos": 2
  },
  "isError": false
}

MCP tool polarsteps_import_steps

Adds up to 50 steps to one trip in a single call and sorts them by date, so the route draws in travel order. Each step needs a place and a date. The OK covers the whole batch. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_import_steps",
    "arguments": {
      "trip_id": "20931176",
      "steps": [
        {
          "place": "Hanoi, Vietnam",
          "date": "2019-03-02T09:00:00+07:00",
          "title": "Arrival in Hanoi"
        },
        {
          "place": "Ha Long Bay, Vietnam",
          "date": "2019-03-05T08:00:00+07:00",
          "title": "Boat to Ha Long Bay"
        }
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "20931176",
    "added": 2,
    "steps": [
      {
        "step_id": "301440018",
        "title": "Arrival in Hanoi",
        "date": "2019-03-02T09:00:00+07:00"
      },
      {
        "step_id": "301440019",
        "title": "Boat to Ha Long Bay",
        "date": "2019-03-05T08:00:00+07:00"
      }
    ]
  },
  "isError": false
}

MCP tool polarsteps_update_step

Changes the fields you send and leaves the rest of the step as it is. Changing the place or date moves the step on the route. Trip start and end dates are not changed. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_update_step",
    "arguments": {
      "step_id": "231908554",
      "fields": {
        "story": "Got lost in the old town, then found a tiny fado bar with six tables."
      }
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "step_id": "231908554",
    "updated": [
      "story"
    ],
    "date": "2026-10-09T19:30:00+01:00"
  },
  "isError": false
}

MCP tool polarsteps_add_step_photos

Attaches photos or videos by URL to a step that already exists. People who can see the trip see them. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_add_step_photos",
    "arguments": {
      "step_id": "step_8c41d2",
      "photo_urls": [
        "https://example.com"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "step_id": "231908554",
    "added": 2,
    "photos_total": 4
  },
  "isError": false
}

MCP tool polarsteps_reply_to_step_comment

Adds a reply under a comment on your step. The reply appears under your name for people who can see the trip. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_reply_to_step_comment",
    "arguments": {
      "step_id": "step_8c41d2",
      "comment_id": "comment_8c41d2",
      "body": "body"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "comment_id": "cm_4822",
    "parent_comment_id": "cm_4821",
    "step_id": "231908554",
    "status": "published"
  },
  "isError": false
}

MCP tool polarsteps_set_trip_privacy

Sets the privacy level of one trip to Only me, Followers or Everyone. It applies to the trip with all its steps. Followers can also see the trip through the secret link. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "polarsteps_set_trip_privacy",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "privacy": "only_me"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "18452237",
    "privacy": "everyone"
  },
  "isError": false
}