ai

Run the app's full extraction pipeline over a shared link (TikTok, Instagram, Reels, YouTube, a blog, a maps link) and s

Run the app's full extraction pipeline over a shared link (TikTok, Instagram, Reels, YouTube, a blog, a maps link) and save what it finds as import candidates on the traveller's account. This is one of only two MCP tools that spends the app owner's AI budget rather than yours: it needs the ai:import scope, it counts against your daily import cap, and it is tightly rate-limited. It reads any language. Country comes from reverse geocoding and category from Google's own types — never from a model — so a result is a verified place, not a model's guess.

post/actions/import_from_url

Request

  • Base URL: https://findinghorizons.ca/api/v1
  • URL: https://findinghorizons.ca/api/v1/actions/import_from_url
  • Auth: OAuth 2 (authorization code, authorization URL https://findinghorizons.ca/api/mcp/authorize, token URL https://findinghorizons.ca/api/mcp/oauth/token, scopes: ai:import)

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

urlstring

The link to extract from

textstring

Optional pasted caption/description to extract from instead of, or as well as, the link

titlestring

Optional title from the share sheet

imageUrlstring

With text only: an https picture of the place, kept as its thumbnail (≤3 MB)

imageBase64string

With text only: the picture as base64 (e.g. one you generated), ≤3 MB

imageIsGeneratedboolean

true when that picture is AI-generated — the app labels it

todaystring

The traveller's own date, YYYY-MM-DD, where the action needs one

expectedVersioninteger

For a change to a trip: the planVersion you last read

Response

Done — { ok, api, action, result, card, operation? }

Changes

No recorded changes to this operation across all 1 revision of this API.