Python Server for Foursquare API
Getting Started
Prerequisites
Follow getting started steps in the project guide.
Python Environment
Ensure that you're running Python 3.10 or higher.
Next install uv, a fast python project manager:
curl -LsSf https://astral.sh/uv/install.sh | sh
or alternatively if you are on a mac you can install with homebrew
brew install uv
(if you already have it installed, make sure it is up to date)
Clone the Repo
This project currently must be cloned locally and run with uv. Clone using:
git clone git@github.com:foursquare/fsq-ai-mcp.git
Then set up the project:
cd fsq-ai-mcp/fsq-server-python
uv venv
uv sync
Configure MCP
You will need to update the ~/Library/Application\ Support/Claude/claude_desktop_config.json configuration. If the file doesn't exit, you can copy paste claude_desktop_config.json from this folder into Claude.
Based on the example claude_desktop_config.json, update the values with
correct local paths and your Service API key and add to claude_desktop_config.json.
"command": "/path/to/uv/bin/uv","args": [...,"/path/to/git/clone/fsq-ai-mcp/fsq-server-python/", ...],"FOURSQUARE_SERVICE_TOKEN": "YOUR FOURSQUARE SERVICE TOKEN"
If the file already exists because you have other local MCP servers, just insert the foursquare
sub-object into the existing config.
Run MCP
Open Claude Desktop. You should see a hammer icon appear in the lower right part of the chat input that says "5 MCP tools available" (or more, if you have installed other MCP servers). There should not be any popup dialogs with errors. Verify by clicking on the hammer that 5 tools from server: foursquare are listed as available.
Finally test it out by asking Claude for place recommendations!
hi claude, can you suggest some good coffee shops near Prospect Heights, Brooklyn?
(It will ask you to allow access to running the foursquare tools)
Metadata
Release files for iflow-mcp_foursquare-foursquaremcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_foursquare_foursquaremcp-0.1.2.tar.gz | 3.5 kB | Without provenance | Details for iflow_mcp_foursquare_foursquaremcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_foursquare_foursquaremcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_foursquare_foursquaremcp-0.1.2-py3-none-any.whl |
Total release size: 7.6 kB
Release files / iflow_mcp_foursquare_foursquaremcp-0.1.2.tar.gz
| Download URL | iflow_mcp_foursquare_foursquaremcp-0.1.2.tar.gz |
|---|---|
| Size | 3.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f9027dae7936d911caa81d45972b619cbbff3a83fa1b8f5b70fda5ae2a710407
|
|
BLAKE2b-256 checksum How to use checksums |
68cca89b9b1af4c43b9b813955f76eeee78a6fcce838df94723eeb01d53493b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_foursquare_foursquaremcp-0.1.2-py3-none-any.whl
| Download URL | iflow_mcp_foursquare_foursquaremcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 4.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
34a7eb10ab44b86158aacbb5e185c9943da79a95d23a525fe58b785582756c7f
|
|
BLAKE2b-256 checksum How to use checksums |
41d45644aa24aa42c847478b90b0e4ee0cb16b0fd209ecaa826d8d5c4529b56b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_foursquare-foursquaremcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.