SafeGraph GraphQL API Connector for AI agents.
10 live capabilities
Get precise geospatial data for retail site selection and foot traffic analysis.
Waiting for input…
Why people use SafeGraph GraphQL API
SafeGraph Site Selection for Retailers
With this Connector, you just tell your agent what you need. You can ask it to find every coffee shop in a specific radius or pull the historical visit metrics for a potential storefront. You get a clear picture of the market in seconds, letting you focus on the strategy instead of the data entry.
What Vinkius changes
You get instant access to professional mobility data without writing a single line of code.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Retail Expansion Mapping
A brand manager asks to find all competitors within 1km of a new site.
- Real-world use case 02
Urban Mobility Analysis
A city planner wants to know how busy a park is.
- Real-world use case 03
Real Estate Footprint Audit
A developer needs the exact shape of a building.
Complete set · 10capabilities
The complete SafeGraph GraphQL API capability set.
These are the exact actions your AI can choose when you ask it to work with SafeGraph GraphQL API.
01—04
4 capabilities in this set.
Part of 10 available through SafeGraph GraphQL API.
- 01 Capability
Lookup parent polygon
Find out which larger complex a location belongs to. Use this to see if a shop is inside a mall or airport.
- 02 Capability
Lookup place patterns
See historical foot traffic and dwell times. This helps you understand how people actually use a space.
- 03 Capability
Lookup placekey
Get every detail about a specific location using its unique ID. It's the quickest way to get a full profile.
- 04 Capability
Search brand places
Find every branch of a specific brand in a city. This is great for competitive mapping and market share analysis.
05—07
3 capabilities in this set.
Part of 10 available through SafeGraph GraphQL API.
- 05 Capability
Search industry naics
Find businesses based on their specific industry codes and region. Use this for deep demographic and market research.
- 06 Capability
Batch lookup placekeys
Look up multiple location IDs at once to save time. Use this when you have a list of keys and need details fast.
- 07 Capability
Graphql raw query
Run custom GraphQL queries for edge cases. This lets you pull specific data points that standard capabilities might miss.
08—10
3 capabilities in this set.
Part of 10 available through SafeGraph GraphQL API.
- 08 Capability
Lookup building geometry
Get the exact polygon shape of a building. It's useful for mapping physical footprints accurately.
- 09 Capability
Search distance radius
Search for any places within a specific distance from a set of coordinates. It helps you define a local area.
- 10 Capability
Search wkt polygon
Find every place located inside a custom geometric polygon. This works for any specific shape you can define.
Set up in minutes
One URL. Then ask SafeGraph GraphQL API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use SafeGraph GraphQL API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it SafeGraph GraphQL API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable SafeGraph GraphQL API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the SafeGraph GraphQL API URL.
- Step 03
Save and start
Save the connection and enable SafeGraph GraphQL API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"safegraph": {
"url": "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using SafeGraph GraphQL API
Open Agent mode in chat and ask: "Using SafeGraph GraphQL API, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"safegraph": {
"url": "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using SafeGraph GraphQL API
Ask Copilot: "Using SafeGraph GraphQL API, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"safegraph": {
"url": "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using SafeGraph GraphQL API
Open Cascade and ask: "Using SafeGraph GraphQL API, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"safegraph": {
"url": "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using SafeGraph GraphQL API
Ask Cline: "Using SafeGraph GraphQL API, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add safegraph --transport http "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using SafeGraph GraphQL API
Ask Claude: "Using SafeGraph GraphQL API, show me...". 10 tools are ready
Where the request belongs
Work SafeGraph GraphQL API can move forward.
Retail site selection managers, urban planners, and real estate developers who are tired of manual data gathering.
Retail Site Selection Manager
You use this to map out brand clusters and foot traffic to decide where to open the next store.
Urban Planner
You use this to see how people move through a city and identify high-traffic zones.
Real Estate Developer
You use this to find building footprints and identify parent complexes for property analysis.
Market Researcher
You use this to filter businesses by industry codes to understand regional competition.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPlacer.ai
Access foot traffic analytics. track visit trends, demographics, and trade areas directly from any AI agent.
Precisely
Equip your AI with precise location intelligence. geocode addresses, resolve property risks, calculate local taxes, and analyze demographics globally.
Baidu Huiyan LBS
Analyze population mobility via Baidu Huiyan. track migration flows, urban crowd density, and perform precision geocoding from any AI agent.
Geoapify
Access powerful location intelligence. geocoding, routing, place search, and IP tracking directly from your AI agent.
Pointr
Grant your AI access to precision indoor mapping. Navigate buildings, track BLE beacons, and find POIs.
Veraset
Equip your agent to seamlessly query Veraset's mobility datasets. Run geospatial SQL, extract insights, and manage S3 buckets.
Bring your own AI
Change the model, client or framework. Keep SafeGraph GraphQL API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about SafeGraph GraphQL API.
The practical details behind the request, access and result.
How does the SafeGraph MCP help with retail site selection?
It gives your AI agent the ability to pull real mobility data. You can quickly identify brand clusters, check foot traffic, and see building footprints to make better decisions on where to open a new location.
Can I use SafeGraph to find specific types of businesses?
Yes, you can search by specific industry codes. This allows your agent to find every business in a category, like 'restaurants' or 'fitness centers,' within a specific region.
What kind of building data does the SafeGraph MCP provide?
It provides precise building geometries. Your agent can retrieve the actual polygon footprint of a building, which is helpful for real estate analysis and mapping.
Can the SafeGraph MCP show me how many people visit a location?
It can. The Connector provides historical foot traffic patterns and dwell times. This helps you understand how many people visit a spot and how long they typically stay there.
Is the SafeGraph MCP good for urban planning?
It's a great capability for urban planners because it provides mobility insights. You can analyze how people move through different zones and identify high-traffic areas based on real data.
Can I search for specific brands using the SafeGraph MCP?
Yes, the Connector includes a capability to search for locations of specific brands in a city. This makes it easy to map out a brand's presence or identify competitors.
Can I manipulate or delete existing POIs present inside the global SafeGraph spatial indexes?
No. The AI interacts safely with the GraphQL API strictly on a 'read-only' query-bound basis. It has absolutely no inherent capability to corrupt or perform unauthorized destructive operations such as erasing core places or overwriting coordinates in your environment.
Are geometric polygons always provided for queried structures automatically?
No, they must be explicitly queried utilizing the lookup_building_geometry functionality along with a verified Placekey, or structured thoroughly using the standard GraphQL command when available. Otherwise most basic list operations only return textual descriptors and simple pinpoint latitude/longitude figures.
Does the AI download huge databases directly into my storage limit when filtering large geographical boundary ranges (WKT)?
The integration employs a managed response methodology natively implemented through GraphQL constraints. The output responses are strictly paginated securely filtering hundreds of points effectively rather than attempting to sync gigabytes directly to the chatbot at once.
One connection away
Give your agent a direct line to SafeGraph GraphQL API.
Connect SafeGraph GraphQL API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available