How to Use the LocationIQ MCP in Mastra AI

Q: Does LocationIQ provide timezone data for Mastra AI schedules?

The timezone tool gives you the exact offset for any coordinate. Use this to ensure your agent operations trigger at the right local time.

Q: Does the LocationIQ server require manual approval in Mastra AI?

You can toggle the requireToolApproval flag in your Mastra config. This forces the agent to ask you before executing sensitive location requests.

Build complex logistics workflows in Mastra AI using LocationIQ tools for automated geocoding and route management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect LocationIQ MCP to Mastra AI

Create your Vinkius account to connect LocationIQ to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup LocationIQ with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated location workflows for Mastra

Chain `search` and `reverse` tools inside your Mastra agents to automate address verification. If an address is missing, the agent triggers a secondary search automatically. This creates a reliable loop for data entry. You define the logic once and the agent handles the edge cases.

Conditional routing with Mastra

Use the `directions` tool to build branching logic based on transit times. The agent evaluates the route and decides whether to alert a human or proceed with the delivery. It handles failures with retries. If the API hits a rate limit, the agent waits and tries again without stopping the workflow.

Nearby POI intelligence

Identify assets using `nearby` to populate agent context. The agent finds points of interest and uses them to make informed decisions about site visits. This keeps the agent focused on relevant data. It filters out noise before passing information to the next step in your pipeline.

Setup guide

Set up LocationIQ MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All LocationIQ tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "locationiq-mcp-client",
  servers: {
    "locationiq-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "LocationIQ Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to LocationIQ tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent LocationIQ transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by LocationIQ. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect LocationIQ now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about LocationIQ MCP in Mastra AI

Add the server URL to your Mastra client configuration. The tools appear automatically, and you just map them to your agent steps.

Your location queries are encrypted in transit. The server acts as a pass-through and doesn't keep a log of your specific address lookups.

Yes. Mastra supports exponential backoff for tool calls. You configure the retry policy in your agent definition to handle transient network issues.

The `timezone` tool gives you the exact offset for any coordinate. Use this to ensure your agent operations trigger at the right local time.

You can toggle the `requireToolApproval` flag in your Mastra config. This forces the agent to ask you before executing sensitive location requests.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript

Mastra AI sdk-typescript

Start using the LocationIQ MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started