Skip to content
Vinkius

SafeGraph GraphQL API Connector for AI agents.

10 live capabilities

Get precise geospatial data for retail site selection and foot traffic analysis.

Live agent request SafeGraph GraphQL API / Connector

Waiting for input…

AI Agent

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.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

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

  1. Real-world use case 01

    Retail Expansion Mapping

    A brand manager asks to find all competitors within 1km of a new site.

  2. Real-world use case 02

    Urban Mobility Analysis

    A city planner wants to know how busy a park is.

  3. 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.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

  1. 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.

  2. 02 Capability

    Lookup place patterns

    See historical foot traffic and dwell times. This helps you understand how people actually use a space.

  3. 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.

  4. 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.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

  1. 05 Capability

    Search industry naics

    Find businesses based on their specific industry codes and region. Use this for deep demographic and market research.

  2. 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.

  3. 07 Capability

    Graphql raw query

    Run custom GraphQL queries for edge cases. This lets you pull specific data points that standard capabilities might miss.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

  1. 08 Capability

    Lookup building geometry

    Get the exact polygon shape of a building. It's useful for mapping physical footprints accurately.

  2. 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.

  3. 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 preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it SafeGraph GraphQL API, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable SafeGraph GraphQL API for the conversation.

Where the request belongs

Work SafeGraph GraphQL API can move forward.

Built around the request

Retail site selection managers, urban planners, and real estate developers who are tired of manual data gathering.

01

Retail Site Selection Manager

You use this to map out brand clusters and foot traffic to decide where to open the next store.

02

Urban Planner

You use this to see how people move through a city and identify high-traffic zones.

03

Real Estate Developer

You use this to find building footprints and identify parent complexes for property analysis.

04

Market Researcher

You use this to filter businesses by industry codes to understand regional competition.

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