Foursquare
Connect your AI agents to Foursquare.
Authentication: OAuth. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.
Check in at a venue. Use search_venues to find venue IDs. Optionally add a shout message.
Get checkin details including venue, shout, likes, and comments.
Delete a checkin. Only the creator can delete their own checkins.
Create a new Foursquare list. Optionally set description and collaborative mode.
Get list details including items (venues). Use get_self_lists to find list IDs.
Update a list’s name, description, or collaborative setting.
Delete a list. Only the creator can delete their own lists.
Add a venue to a list. Use search_venues for venue IDs. Optionally add text.
Remove an item from a list. Use get_list to find item IDs.
Autocomplete for venues and places. Provide query with optional ll or near for location bias.
Get venue recommendations near a location, optionally filtered by query. Provide ll or near.
Add a tip to a venue (max 200 chars). Use search_venues to find venue IDs.
Get tip details including text, venue, author, and likes.
Delete a tip. Only the author can delete their own tips.
Get the authenticated user’s profile including name, home city, checkin/list/tip counts.
Get the authenticated user’s checkin history with pagination. Filter by before/after timestamps.
Get the authenticated user’s lists. Filter by group: created, edited, followed, friends, suggested.
Get tips the authenticated user has written. Sort by recent, nearby, or popular.
Get the authenticated user’s taste preferences (e.g., ‘craft beer’, ‘sushi’, ‘live music’).
Validate Foursquare OAuth2 credentials by fetching the current user profile. Returns {success, message}.
Search venues by location+query. Provide ll or near. Use get_categories for category IDs. Returns paginated results.
Get venue details by ID including location, categories, ratings, hours, and stats. Use search_venues to find IDs.
Get photos for a venue. Build URLs: prefix + {width}x{height} + suffix. Use offset for pagination.
Get tips for a venue. Sort by friends, recent, or popular. Use offset for pagination.
Get operating hours for a venue with timeframes and open/close times.
Get venue attributes like outdoor seating, Wi-Fi, live music, parking, and more.
Get all venue categories as a hierarchical tree with IDs and names. Use category IDs to filter search_venues.
Get trending venues near a lat/lng coordinate. Returns venues with high recent activity.