Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use SafeGraph GraphQL API with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Integrate SafeGraph's premier geospatial dataset into your AI. Discover detailed POIs, analyze foot traffic patterns, and process precise building geometries se

Included with plan

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.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

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

    Lookup parent polygon

    Identifies the parent Placekey for a location (e.g., mall or airport)

  2. 02

    Lookup placekey

    Retrieves detailed attributes for a specific location by its Placekey

  3. 03

    Search brand places

    G., "Starbucks") in a specific city. Searches for locations of a specific brand in a city

  4. 04

    Search industry naics

    Searches for places by NAICS industry code and region

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

  1. 05

    Graphql raw query

    Provide the query string and optional variables. Executes a raw GraphQL query against the SafeGraph API

  2. 06

    Lookup building geometry

    Retrieves the building footprint (polygon) for a specific Placekey

  3. 07

    Batch lookup placekeys

    Provide them as a JSON array. Performs multiple Placekey lookups in a single request

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through SafeGraph GraphQL API.

  1. 08

    Lookup place patterns

    Retrieves historical foot traffic patterns for a specific Placekey

  2. 09

    Search distance radius

    Specify lat, lon, and radius in meters. Searches for places within a specific radius from a point

  3. 10

    Search wkt polygon

    Finds all places within a specific geometric polygon (WKT)

Observed, not estimated

888ms average. Fast in production.

SafeGraph GraphQL API is checked daily against the live service.

Daily averagePeak 1038ms
Aug 20Today
Fastest day
754ms
Slowest day
1038ms
14-day trend
Stable-3%

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.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 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

FAQ

Questions SafeGraph GraphQL API owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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

Suggestions