# Veraset MCP for AI Agents AI Agent Connect > Veraset MCP gives your AI agent direct access to massive geolocation and mobility datasets. You can run SQL queries on billions of points of interest, profile datasets in real-time, and manage S3 delivery buckets without leaving your favorite chat interface. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WyJVIYHTFBZLnrJEVxBMkosMzJgHAkxuEd8yrcsO/ai-agent-connect - **Tags:** geolocation, mobility-data, geospatial-sql, poi-data, data-extraction, s3-integration ## Description Stop jumping between browser tabs to pull mobility data. This Connector puts Veraset’s geolocation datasets right inside your AI client, so you can ask questions about foot traffic or signal movement as easily as you'd ask for a summary. Instead of manually checking schemas or waiting for exports, you can have your agent pull samples, run complex SQL, and check the status of long-running jobs in one place. It’s about getting to the 'why' of the data faster. If you're already using Vinkius to manage your stack, this is the missing piece for anyone who needs to handle large-scale geospatial analysis without the overhead of constant context switching. You just provide your API key and start talking to your data. You can explore specific datasets, check the column types to ensure your queries won't break, and even grab temporary links for your S3 buckets. It turns a multi-step data retrieval process into a single conversation. Whether you are checking POI foot traffic for a retail strategy report or analyzing movement patterns for a logistics project, this tool removes the friction of the underlying infrastructure. You get to spend less time on the 'how' of data fetching and more time on the 'what' of the actual insights. ## Tools ### get_dataset_metadata Pulls technical metadata for a specific mobility dataset to see what's available. It provides the high-level details you need before you start writing queries. ### get_query_results Fetches the rows from a finished SQL query with support for pagination. This allows you to pull large datasets in manageable chunks. ### get_query_status Shows the current progress and scanned bytes of a running SQL job. You can use this to monitor heavy queries without guessing if they're still working. ### get_dataset_sample Grabs a few rows from a dataset so you can see the actual data format. It's the fastest way to verify that the columns contain the information you expect. ### get_dataset_schema Returns the column definitions and data types for any given dataset. Use this to get the exact field names before you construct your SQL. ### list_mobility_datasets Shows all the mobility datasets you have permission to access in Veraset. It gives you a clear overview of every data source available to your organization. ### cancel_running_query Stops a currently executing SQL task immediately if it's no longer needed. This helps you clear your queue when you realize a query is going in the wrong direction. ### execute_sql_query Starts a new SQL query task against a specific Veraset dataset using ANSI SQL. It returns a unique query ID so you can track the progress of your request. ### generate_download_link Creates a temporary pre-signed URL for downloading files from your S3 bucket. You can use this to grab data for local analysis without dealing with complex AWS permissions. ### list_s3_delivery_folders Lists the S3 prefixes where your scheduled data drops are actually delivered. This helps you find the right path for your bulk downloads. ## Prompt Examples **Prompt:** ``` What columns are in the 'movement_global' dataset? ``` **Response:** ``` The `movement_global` dataset includes the following columns: | Column Name | Data Type | | :--- | :--- | | `id_type` | String | | `accuracy` | Float | | `timestamp` | DateTime | | `latitude` | Float | | `longitude` | Float | | `country` | String | Would you like me to run a sample query on these columns? ``` **Prompt:** ``` Give me a 10-row sample of the 'visits' data. ``` **Response:** ``` Here is a sample of the first 10 rows from the `visits` dataset: | `ad_id` | `accuracy` | `timestamp` | `lat` | `long` | `country` | | :--- | :--- | :--- | :--- | :--- | :--- | | 8821 | 10m | 2023-11-20T10:00Z | 34.05 | -118.24 | USA | | 8822 | 15m | 2023-11-20T10:01Z | 51.50 | -0.12 | GBR | | ... | ... | ... | ... | ... | ... | The data appears to be correctly populated. ``` **Prompt:** ``` List our S3 folders and give me a link for the latest weekly file. ``` **Response:** ``` I found 3 S3 delivery prefixes for your organization: - `veraset-delivery-east-1/org/xyz/weekly-visits/` - `veraset-delivery-east-1/org/xyz/movement-v3/` - `veraset-delivery-east-1/org/xyz/poi-base/` I've generated a temporary download link for the latest file in the weekly visits folder: `https://s3.veraset.com/secure-link-xyz-7721` *(Link expires in 1 hour)* ``` ## Capabilities ### Run SQL on mobility datasets Execute complex ANSI SQL queries directly against Veraset geolocation data. ### Check progress of long-running jobs Monitor the status and scanned bytes of active SQL queries in real-time. ### Preview raw data rows Pull a quick sample of the first few rows to verify dataset contents. ### View dataset schemas Get instant access to column definitions and data types for any dataset. ### Generate secure S3 download links Create temporary pre-signed URLs for downloading bulk files from S3. ### List available mobility folders Identify all accessible mobility datasets and S3 delivery prefixes. ## Use Cases ### Retail Foot Traffic A retail lead asks for a summary of store visits in a city. The agent uses `execute_sql_query` and `get_query_results` to pull the totals. This gives the lead a quick look at foot traffic without them having to write any code. ### Data Validation A scientist needs to know if a dataset has "lat" and "long" columns. The agent uses `get_dataset_schema` to verify the field names. They can then confirm the data is ready for their pipeline. ### Bulk Exporting An engineer needs to move data to a local machine. The agent uses `list_s3_delivery_folders` and `generate_download_link` to find the right path. This saves the engineer from digging through AWS consoles to find specific folders. ### Query Debugging A dev realizes a query is taking too long. The agent uses `cancel_running_query` to stop it and restart with a smaller subset. This keeps the execution environment clean and prevents wasted resources. ## Benefits - Stop guessing column names by using `get_dataset_schema` to see data types before you write a single line of SQL. - Keep an eye on big jobs with `get_query_status` so you know exactly how many bytes your agent has scanned so far. - Verify your data logic instantly with `get_dataset_sample` to see the first few rows of any mobility set. - Grab files without the AWS headache by using `generate_download_link` to get a temporary S3 key on demand. - Browse your available data sources easily with `list_mobility_datasets` to see every package you can query. - Find your data drops in seconds using `list_s3_delivery_folders` to see exactly where your organization's files land. ## How It Works The bottom line is you get to query billions of geolocation records using plain English instead of manual dashboard navigation. 1. Subscribe to the Veraset MCP and install it into your preferred AI client. 2. Provide your private Veraset API key to authorize the connection. 3. Ask your agent to pull mobility data or run SQL queries using natural language. ## Frequently Asked Questions **What can I do with the Veraset MCP?** You can use the Veraset MCP to query massive geolocation and mobility datasets using SQL. It allows your AI client to pull data samples, check dataset schemas, and manage S3 download links directly. **How do I query mobility data with the Veraset MCP?** Simply ask your AI agent to run a specific SQL query on a dataset. The Connector handles the connection, executes the query, and brings the results back into your chat for analysis. **Can the Veraset MCP help me find S3 folders?** Yes, it can list all the S3 prefixes where your scheduled data drops are delivered. You can then ask the agent to generate a temporary download link for any file in those folders. **Is the Veraset MCP good for retail foot traffic analysis?** It's ideal for retail strategy. You can quickly pull summaries of foot traffic by store ID or location without needing to navigate complex AWS architectures or manual dashboards. **Can I use the Veraset MCP to see dataset schemas?** Yes, you can ask the agent to show you the column definitions and data types for any specific mobility dataset. This helps you write accurate SQL queries without any guesswork. **How does the Veraset MCP handle long-running SQL queries?** The Connector can track the progress of long-running jobs. You can ask your agent for a status update at any time to see how many bytes have been scanned and how far along the query is. **Can the AI really create and download a pre-signed link from Veraset's S3 directly?** Yes. Upon using the `generateDownloadLinkTool`, the agent will interface via Veraset's protocol using your API token, instantly retrieving an authenticated, time-sensitive download link to let you extract the immense dataset files securely. **What happens if a SQL statement to Veraset starts taking too long?** You don't need to panic or swap tools. Instruct your agent: `cancel the running query id 'query-xx9'`, and the `cancelQueryTool` fires an immediate abort network call. The computation ends, saving extensive costs without abandoning the conversational flow. **How can I preview geolocation signals before compiling expensive queries?** Ask for the `getSchemaTool` followed by `getSampleTool`. The AI perfectly delivers the dataset definitions and outputs five physical preview rows right inside your message history, confirming expected structure formatting.