Foursquare
for LuumenAI

Look up venues, nearby places, and location detail without leaving the terminal

Ask about a place and get an answer in the terminal. Luumen searches Foursquare with FOURSQUARE_SEARCH_PLACES_API_REQUEST, pulls detail by ID with FOURSQUARE_RETRIEVE_PLACES_BY_ID, and lists what is close by with FOURSQUARE_RETRIEVE_NEARBY_PLACES_V3. This integration is read-only: eight tools, no writes. Connect it with an API key.

The Foursquare toolbox

8 tools, all read-only. They answer instantly, and every call is logged.

  • ReadAutocomplete placesReturns autocomplete suggestions for places as the user types their search query.
  • ReadGet trending venuesRetrieves venues currently trending in a specified geographic area, sorted by popularity based on recent foot traffic and activity patterns.
  • ReadRetrieve nearby places v3The GetNearbyPlaces endpoint retrieves a list of places near a specified location, primarily supporting check-in use cases and local discovery.
  • ReadRetrieve place photos by idRetrieves photos associated with a specific place in Foursquare's database.
  • ReadRetrieve places by idRetrieves detailed information about a specific place using its unique Foursquare ID (FSQ ID).
  • ReadRetrieve place tips using fsq idRetrieves user-generated tips for a specific place in the Foursquare database.
  • ReadSearch places api requestThe GetPlacesSearch endpoint allows you to search for places in the Foursquare database based on various criteria such as location, keywords, and categories.
  • ReadValidate API credentialsValidates Foursquare API credentials by performing a lightweight place search.

Questions

How does LuumenAI connect to Foursquare?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Foursquare on its own?

No. Every one of the 8 tools LuumenAI has for Foursquare is read-only, so it can answer questions from Foursquare but cannot change anything in it. Reads are not gated — they answer immediately, and each one is recorded on the audit trail with the actor and the result.

Who gets access to the integration?

You decide. Access is granted per agent, skill, and team, and per environment — production is not staging.

Is there an audit trail?

Every call to Foursquare is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Foursquare to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.