Tools

Photos and data

Find photos, read Instagram and TikTok posts, and look up apps, movies and shows.

Lookups your agent uses while it writes. They return data and small previews for the agent to check, and show the user nothing.

pinterest_search

Free

Search Pinterest, or read a board the user shared. Best for aesthetic, TikTok-style photos.

Parameters

querystring

What to search Pinterest for, in Pinterest's aesthetic terms: "soft girl morning routine aesthetic", "couple holding hands film photo", "cozy coffee shop rainy day". Leave out when you pass board_url.

board_urlstring

A Pinterest board (or board section) link the user gave, e.g. https://www.pinterest.com/<user>/<board>/ or a pin.it short link to one, to use that board's photos. Leave out when you pass query.

countnumber

How many photos to return (default 8).

orientationstring

Preferred orientation, ranked first (default portrait, for 9:16 or 4:5 slides).

portraitlandscapeany
cursorstring

next_cursor from an earlier call with the same query or board_url, for the next photos. Only when the user wants more or different photos from that search or board.

image_search

Free

Search Google Images for photos of specific real things: places, products, people, album covers.

Parameters

querystringrequired

What the photo should show, like a Google Images search: "grizzly bear walking on train tracks Banff". Specific subjects beat abstract ideas.

countnumber

How many photos to return (default 6).

orientationstring

Preferred orientation, ranked first (default portrait, for 9:16 or 4:5 slides).

portraitlandscapeany

upload_image

Free

Upload a photo the user attached in the chat, so it can go in a slide.

  • Returns an upload link the agent sends the file to from its code tool (in Claude, that's code execution).

Parameters

No parameters.

social_post

Free

Open an Instagram post or TikTok photo slideshow and read its slides and caption.

Parameters

urlstringrequired

Link to a public Instagram post or carousel (instagram.com/p/…) or TikTok photo slideshow (tiktok.com/@user/photo/…).

show_slidesboolean

Also show small images of the slides (up to 20), labelled "Slide N", so you can see their layout, text and style. Default true.

app_store

Free

Look up iPhone apps by name, id or top chart, with icons, screenshots and store descriptions.

Parameters

searchstring

Find apps by name, e.g. "strava". Best match first.

idsstring[]

App Store ids (426826309) or apps.apple.com links, returned in the same order.

chartstring

Read an App Store top chart (iPhone apps). Combine with genre for a category chart.

top-freetop-paidtop-grossing
genrestring

App Store category: health-fitness, productivity, lifestyle, finance, education, entertainment, games, music, photo-video, social-networking, shopping, travel, utilities, food-drink, sports, news, business, books, medical, navigation, reference, weather, graphics-design, developer-tools.

countnumber

How many apps (default 10).

countrystring

Two-letter App Store country, default "us".

show_screenshotsboolean

Also show small images of each app's first 4 screenshots (first 8 apps), labelled "App N, screenshot K", so you can pick the one that shows the app's real screen. screenshot_url is only the first portrait screenshot, which is often a marketing banner or award card.

movies_tv

Free

Movies, TV shows and the people in them: rankings, details, where to watch, posters and stills.

Parameters

actionstringrequired

search: find titles or people by name (query). list: a ready-made list (list). trending: what's trending (time_window). discover: rank titles by filters (genres, released_from/released_to or year, sort_by, min_votes, language, watch_providers), e.g. top rated movies of 2025. details: one title or person in full (id): cast, directors, runtime, seasons, where to watch, a person's biography and best known credits. season / episode: a TV season's episodes or one episode (id, season, episode). reviews: a title's reviews, highest rated first. images: alternative posters, backdrops and logos (or a person's photos). providers: the streaming services in region.

searchlisttrendingdiscoverdetailsseasonepisodereviewsimagesproviders
typestring

movie (default), tv or person; "all" mixes them (search and trending only). providers defaults to tv.

movietvpersonall
querystring

For search: a title or name, e.g. "dune", "zendaya".

yearnumber

For search, a release year to narrow matches; for discover, shorthand for released_from/released_to covering that year.

liststring

For list: movies have popular, top_rated, now_playing, upcoming; tv has popular, top_rated, airing_today, on_the_air; person has popular.

populartop_ratednow_playingupcomingairing_todayon_the_air
time_windowstring

For trending: today or this week (default week).

dayweek
idnumber

The movie, show or person id from a search or list result, for details, season, episode, reviews and images.

seasonnumber

Season number (0 is specials), for season and episode.

episodenumber

Episode number, for episode.

genresstring[]

For discover: genre names a title must all have, e.g. ["horror", "comedy"].

released_fromstring

For discover: earliest release (movies) or first air date (tv), YYYY-MM-DD.

released_tostring

For discover: latest release or first air date, YYYY-MM-DD.

sort_bystring

For discover (default popularity). rating ranks by audience score and needs enough votes (min_votes defaults to 300 for movies, 150 for tv); revenue is movies only.

popularityratingvotesrevenuenewest
min_votesnumber

For discover: only titles with at least this many votes.

languagestring

For discover: original language, e.g. "ko" for Korean films.

watch_providersstring[]

For discover: only titles streaming on these services in region, e.g. ["Netflix"].

regionstring

Two-letter country for where to watch, certifications and movie lists (default "US").

countnumber

How many results (default 10, up to 40).

pagenumber

Start from this page of 20 results, for more after an earlier call (its next_page).

show_imagesboolean

Also show small images of the results' posters, photos or stills (up to 12), labelled, so you can check them.

Photos and data - ReelFarm MCP docs