How to Use the Foursquare Alternative MCP in Claude Code

Q: How do I add the Foursquare Alternative MCP Server to Claude Code?

Run the command claude mcp add --transport http foursquare-alternative -- in your terminal. Make sure all transport and setup flags are placed before the server name.

Q: How does Claude Code verify that Foursquare Alternative MCP is active?

Run claude mcp list in your terminal. This command lists all active servers, confirming that tools like getnearbyplaces and listcategories are registered and ready for execution.

Q: Can I pipe the output of these terminal tools to other files?

Yes. You can instruct Claude Code to run getplacephotos and redirect the raw URL output directly into a local JSON file or pass it to a curl command to download the assets.

Pipe Foursquare Alternative location data directly into your terminal workflows and CI/CD pipelines with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Foursquare Alternative MCP to Claude Code

Create your Vinkius account to connect Foursquare Alternative to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Foursquare Alternative with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run headless location audits from your terminal shell

`get_nearby_places` lets you pull nearby venue coordinates directly into your bash scripts and terminal pipelines. Claude Code runs headless queries, letting you pipe raw JSON location payloads directly into tools like jq, grep, or custom python scripts. You don't need a browser or an IDE to check local data. Run a single command to find venues, and let Claude Code output the exact coordinate arrays you need for your backend configuration files.

Claude Code automates data syncing with this MCP Server

`get_place_details` pulls direct venue metadata into your CLI environment, allowing Claude Code to run automated database updates or sync scripts. You can schedule cron jobs where Claude Code fetches fresh operating hours, addresses, and contact info, writing them directly to your production database. The CLI agent handles the authentication and request formatting automatically. It uses `get_place_tips` to pull down fresh user feedback, appending the text directly to your local log files or data stores.

Build automated category mapping scripts via Claude Code

`list_categories` outputs the entire venue taxonomy straight to your terminal, letting Claude Code build automated mapping dictionaries. This is perfect for backend engineers who need to normalize incoming location data against a standardized schema. Claude Code runs the tool, reads the stdout, and writes a clean mapping script in your language of choice. It then validates the script by running `search_places` to ensure live queries are categorized correctly.

Setup guide

Set up Foursquare Alternative MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see foursquare-alternative-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Foursquare Alternative transactions." It will automatically discover and invoke the available Foursquare Alternative tools.

Terminal

claude mcp add --transport http foursquare-alternative-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Foursquare Alternative MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "foursquare-alternative-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Foursquare. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Foursquare Alternative now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Foursquare Alternative MCP in Claude Code

Run the command `claude mcp add --transport http foursquare-alternative -- ` in your terminal. Make sure all transport and setup flags are placed before the server name.

Yes, since Claude Code is a terminal tool, you can run it headlessly in GitHub Actions or Docker. It can trigger `search_places` or `get_place_details` as part of your automated testing pipeline.

Run `claude mcp list` in your terminal. This command lists all active servers, confirming that tools like `get_nearby_places` and `list_categories` are registered and ready for execution.

Yes. You can instruct Claude Code to run `get_place_photos` and redirect the raw URL output directly into a local JSON file or pass it to a curl command to download the assets.

Your API keys and raw venue metadata are fully protected. Vinkius processes all requests inside an ephemeral, zero-trust sandbox, ensuring that your secret tokens and geographic coordinates are never exposed to external logs or persistent storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript