How do I connect this MCP to my AI client?

You add the SafeGraph MCP to your workspace and provide your SafeGraph GraphQL API key in the settings. Once connected, it is ready to use in Claude, Cursor, or Windsurf.

What kind of geospatial data can my agent access?

Your agent can access building footprints, POI details, industry codes via NAICS, and historical foot traffic patterns.

Do I need to know how to write GraphQL?

No. While you can use the graphql_raw_query capability for complex requests, most tasks can be done using simple natural language prompts.

Can I find specific brands in a city?

Yes. You can use the search_brand_places capability to find specific brand locations within a designated city.

How does the foot traffic data work?

The lookup_place_patterns capability retrieves historical aggregation points, including visit frequencies and median dwell times for specific Placekeys.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Safegraph to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Turn your AI into a professional geographic analyst.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

01
Graphql raw query
This capability executes a raw GraphQL query against the SafeGraph API. Use it to run custom queries with specific variables for edge cases.
02
Lookup building geometry
This capability retrieves the exact WKT polygon for a specific building. It uses a Placekey to identify the physical footprint.
03
Lookup parent polygon
This capability identifies the parent Placekey for a given location. It helps you find the boundaries of larger structures like malls or airports.
04
Search distance radius
This capability finds places within a specific distance from a coordinate. You provide the latitude, longitude, and radius in meters.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

05
Search wkt polygon
This capability searches for locations contained within a specific geometric polygon. You provide the search area using WKT format.
06
Batch lookup placekeys
This capability performs multiple Placekey lookups in a single request. You pass a JSON array of keys to get data in bulk.
07
Lookup place patterns
This capability pulls historical foot traffic data for a specific Placekey. It provides insights into visit frequencies and mobility trends.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

08
Lookup placekey
This capability retrieves detailed attributes for a single location. It requires a specific Placekey to return the data.
09
Search brand places
This capability finds locations for a specific brand within a city. You specify the brand name and the target city.
10
Search industry naics
This capability filters places by NAICS industry codes and regions. It is useful for targeted industry analysis.

Real work

What teams actually run

Competitor Proximity Analysis

Ask your agent to find all competitors within a 500 meter radius of a specific coordinate.

Foot Traffic Auditing

Use the AI to check the historical visitor volume and dwell times for a potential retail site.

Market Segmentation

Query specific NAICS industry codes within a region to understand local business density.

Site Boundary Verification

Retrieve exact WKT polygons to confirm the physical footprint of a building or property.

Automate a task

Put SafeGraph GraphQL API to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

SafeGraph GraphQL API works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put SafeGraph GraphQL API to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

955ms average. Fast in production.

SafeGraph GraphQL API is checked daily against the live service.

Daily averagePeak 1058ms

Oct 3Today

Fastest day: 745ms
Slowest day: 1058ms
14-day trend: Slowing+11%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of SafeGraph GraphQL API, so you can see the experience inside your AI.

It does not authenticate your account with SafeGraph GraphQL API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

SafeGraph GraphQL API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — SafeGraph GraphQL API capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "safegraph-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_k1VELw4KIkAhLWgPfwAjiTkVivxf9F11OxjjYZy2/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up SafeGraph GraphQL API in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work SafeGraph GraphQL API owners hand off.

This MCP is built for professionals who need to turn geographic data into actionable intelligence without writing custom code.

01
Real Estate Analysts
They use the AI to find available commercial spaces or analyze competitor footprints in specific areas.
02
Retail Strategists
They task the agent with analyzing foot traffic patterns and brand density in target markets.
03
Site Selection Experts
They use building geometries and industry filters to identify optimal locations for new businesses.

FAQ

Questions SafeGraph GraphQL API owners ask.

01
How do I connect this MCP to my AI client?
You add the SafeGraph MCP to your workspace and provide your SafeGraph GraphQL API key in the settings. Once connected, it is ready to use in Claude, Cursor, or Windsurf.
02
What kind of geospatial data can my agent access?
Your agent can access building footprints, POI details, industry codes via NAICS, and historical foot traffic patterns.
03
Do I need to know how to write GraphQL?
No. While you can use the graphql_raw_query capability for complex requests, most tasks can be done using simple natural language prompts.
04
Can I find specific brands in a city?
Yes. You can use the search_brand_places capability to find specific brand locations within a designated city.
05
How does the foot traffic data work?
The lookup_place_patterns capability retrieves historical aggregation points, including visit frequencies and median dwell times for specific Placekeys.
06
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.
07
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.
08
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.

Explore

More in Data Analytics

Connect SafeGraph GraphQL API to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Graphql raw query

Lookup building geometry

Lookup parent polygon

Search distance radius

05-07

Search wkt polygon

Batch lookup placekeys

Lookup place patterns

08-10

Lookup placekey

Search brand places

Search industry naics

What teams actually run

Competitor Proximity Analysis

Foot Traffic Auditing

Market Segmentation

Site Boundary Verification

Building your own app? The connector is yours to use.

SafeGraph GraphQL API Connector

Claude Desktop

Real Estate Analysts

Retail Strategists

Site Selection Experts

How do I connect this MCP to my AI client?

What kind of geospatial data can my agent access?

Do I need to know how to write GraphQL?

Can I find specific brands in a city?

How does the foot traffic data work?

Can I manipulate or delete existing POIs present inside the global SafeGraph spatial indexes?

Are geometric polygons always provided for queried structures automatically?

Does the AI download huge databases directly into my storage limit when filtering large geographical boundary ranges (WKT)?

Mapbox (Maps & Geospatial) AI Connector

HERE (Location & Maps) AI Connector

Foursquare AI Connector

LocationIQ (Geocoding & Maps) AI Connector

Suggestions

Data Pipeline Prover AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector

Mapulus AI Connector

Data.gov Catalog AI Connector