Can my agent search for places within a specific drawn area (polygon)?

Yes. Use the 'search_within_polygon' tool. Provide a coordinate string representing the multi-point geometry. The agent will analyze the localized boundaries and restrict the POI lookup strictly inside that drawn area.

How do I retrieve the opening hours and ratings for a venue via chat?

Use the 'get_place_details' tool. Provide the Foursquare ID (fsq_id). The agent will fetch the full payload including operating hours, average ratings, and price levels natively from the places graph.

Can I see photos and user tips for a specific store through the agent?

Absolutely. Use the 'get_place_photos' and 'get_place_tips' tools. Your agent will pull dynamic image URLs and capture raw text sentiments left by other visitors to help you evaluate venue quality flawlessly.

Foursquare MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: Foursquare
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Foursquare through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Foursquare Assistant",
            instructions=(
                "You help users interact with Foursquare. "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Foursquare"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Foursquare MCP Server

Connect your Foursquare account to any AI agent and take full control of your geospatial intelligence and place discovery workflows through natural conversation.

The OpenAI Agents SDK auto-discovers all 10 tools from Foursquare through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Foursquare, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Place Discovery Orchestration — Identify bounded routing spaces inside the headless Foursquare POI graph and extract explicitly attached REST arrays targeting specific search queries near any GPS pin
Rich Metadata Inspection — Perform structural extraction of properties driving active node schemas, retrieving mega-document payloads including hours, ratings, and precise mapping arrays natively
Visual & Social Auditing — Retrieve explicit cloud logging tracing media URL limits to compile dynamic image URLs and capture raw text sentiments left by humans to track venue quality
Geospatial Intelligence — Execute immediate queries within custom drawn multi-point geometries or specific radius boundaries to find what exists physically adjacent to any target
Precise Venue Matching — Dispatch automated validation checks routing explicit duplication logic to force Foursquare to confidently return exactly one node for ambiguous strings
Intelligent Autocomplete — Provision highly-available JSON payloads generating fast typeaheads by querying partial letters to predict user intent natively
Taxonomy Oversight — Enumerate explicitly attached structured rules exporting the entire official Foursquare classification tree to resolve internal type codes flawlessly

The Foursquare MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Foursquare to OpenAI Agents SDK via MCP

Follow these steps to integrate the Foursquare MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from Foursquare

Why Use OpenAI Agents SDK with the Foursquare MCP Server

OpenAI Agents SDK provides unique advantages when paired with Foursquare through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Foursquare + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Foursquare MCP Server delivers measurable value.

Automated workflows: build agents that query Foursquare, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries Foursquare, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Foursquare tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Foursquare to resolve tickets, look up records, and update statuses without human intervention

Foursquare MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect Foursquare to OpenAI Agents SDK via MCP:

autocomplete_venues

Provision a highly-available JSON Payload generating fast typeaheads

get_place_details

Perform structural extraction of properties driving active Node schemas

get_place_photos

Retrieve explicit Cloud logging tracing explicit Media URL limits

get_place_tips

Identify precise active arrays spanning native User Reviews

list_venue_categories

Enumerate explicitly attached structured rules exporting active Taxonomy

match_venue_exactly

Dispatch an automated validation check routing explicit Duplication logic

search_nearby_venues

Inspect deep internal arrays mitigating specific Radius targets

search_places

Identify bounded routing spaces inside the Headless Foursquare POI graph

search_within_polygon

Retrieve the exact structural matching verifying Geofence alternatives

search_within_radius

Irreversibly vaporize explicit validations extracting rich schema scopes

Example Prompts for Foursquare in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Foursquare immediately.

"Find coffee shops near '40.71, -74.00'"

"What are the opening hours for 'Central Park Zoo'?"

"Show me user tips for 'The Met Museum'"

Troubleshooting Foursquare MCP Server with OpenAI Agents SDK

Common issues when connecting Foursquare to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Foursquare + OpenAI Agents SDK FAQ

Common questions about integrating Foursquare MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.