by foursquare
Provides AI agents with contextual location data and place‑search capabilities through the Foursquare Places API via the Model Context Protocol.
Enables an MCP server to expose Foursquare Places API functions so that large language models can query real‑time location information, discover nearby venues, and retrieve rich metadata such as photos, ratings, hours, and popularity.
fsq-server-python/README.md
to run the Python‑based server (e.g., uvicorn
).Q: Do I need a paid Foursquare account? A: A free developer account provides a starter credit sufficient for testing; higher usage requires a paid plan.
Q: Which programming languages are supported? A: The repository currently offers a Python server implementation. Node.js wrappers could be added later.
Q: Can I run the server in production? A: At the moment MCP is geared toward local development with Claude Desktop. Remote production servers are planned.
Q: How do I expose the server to an LLM?
A: Start the server (e.g., uvicorn fsq_server:app
) and configure the LLM client with the server’s URL and the API key via environment variables.
The Foursquare Places API provides detailed location context for apps that need to understand where a user is and what's around them. Powered by a global, open source database of 100 million places across more than 1500 categories, they convert raw GPS data into meaningful insights.
The GeoTagging API pinpoints exact locations—from coffee shops to parks—with high accuracy using Foursquare's Place Snap technology, while the Search & Data APIs go beyond basic proximity, allowing developers to filter places by category, features, hours, and more. Each result includes rich metadata like photos, reviews, ratings, and real-time popularity.
These tools make it possible to build AI Agents that are situationally aware and tailored to the user's surroundings for a highly personalized experience.
Model Context Protocol is a new standard from Anthropic for connecting AI systems with data sources. Read more about it at Anthropic.
MCP allows you to set up servers that expose functions that an LLM can understand and call directly. In this project, we implement an MCP server that can access the Foursquare API in order to support local search for places.
You will need a Foursquare Service API Key to allow your AI agent to access Foursquare API endpoints. If you do not already have one, follow the instructions on Foursquare Doc - Manage Your Service API Keys to create one.
You will need to log in to your Foursquare developer account or create one if you do not have one (creating a basic account is free and includes starter credit for your project). Be sure to copy the Service API key upon creation as you will not be able to see it again.
Currently MCP is only supported for local use, so you should download the Claude Desktop App (remote production MCP servers are still in the works).
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by exa-labs
Provides real-time web search capabilities to AI assistants via a Model Context Protocol server, enabling safe and controlled access to the Exa AI Search API.
by elastic
Enables natural‑language interaction with Elasticsearch indices via the Model Context Protocol, exposing tools for listing indices, fetching mappings, performing searches, running ES|QL queries, and retrieving shard information.
by graphlit
Enables integration between MCP clients and the Graphlit platform, providing ingestion, extraction, retrieval, and RAG capabilities across a wide range of data sources and connectors.
by mamertofabian
Fast cross‑platform file searching leveraging the Everything SDK on Windows, Spotlight on macOS, and locate/plocate on Linux.
by cr7258
Provides Elasticsearch and OpenSearch interaction via Model Context Protocol, enabling document search, index management, cluster monitoring, and alias operations.
by liuyoshio
Provides natural‑language search and recommendation for Model Context Protocol servers, delivering rich metadata and real‑time updates.
by ihor-sokoliuk
Provides web search capabilities via the SearXNG API, exposing them through an MCP server for seamless integration with AI agents and tools.
by fatwang2
Provides web and news search, URL crawling, sitemap extraction, deep‑reasoning, and trending topic retrieval via Search1API, exposed as an MCP server for integration with AI clients.
by cnych
Provides SEO data retrieval via Ahrefs, exposing MCP tools for backlink analysis, keyword generation, traffic estimation, and keyword difficulty, with automated CAPTCHA solving and response caching.