How to Use the Jawg Maps (Location & Routing) MCP in Mastra AI

Q: Can I automate address searching with Jawg Maps (Location & Routing) in Mastra AI?

You can. By adding searchmapplaces to your agent, Mastra AI can perform lookups as part of a multi-step task.

Q: Can I filter searches by country in Mastra AI?

You use searchcountryfilter. It restricts the search scope to the specific region you define in your agent's instructions.

Build reliable logistics workflows in Mastra AI using the Jawg Maps (Location & Routing) MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Jawg Maps (Location & Routing) MCP to Mastra AI

Create your Vinkius account to connect Jawg Maps (Location & Routing) 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 Jawg Maps (Location & Routing) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated route planning for Mastra AI

Chain your routing logic together using `calculate_routing_line` within a Mastra AI workflow. If a route calculation fails, you can trigger a retry block immediately. This keeps your operations running. The framework manages the state of the call, ensuring your agent knows exactly where the routing process stands.

Elevation-aware logistics workflows

Add terrain analysis to your agent's decision tree with `calculate_elevation_routing`. Mastra AI uses this to calculate fuel costs based on path steepness. It makes your agents smarter. They can choose routes that save money or protect vehicle health based on the elevation data returned by the server.

Conditional reachability checks

Use `calculate_reachability_isochrone` to define service zones in your agents. Mastra AI can branch logic based on whether a destination falls inside the reachable area. This automates dispatching. You set the time limit, and the agent decides if a delivery is viable based on the tool output.

Setup guide

Set up Jawg Maps (Location & Routing) 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 Jawg Maps (Location & Routing) 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: "jawg-maps-location-routing-mcp-client",
  servers: {
    "jawg-maps-location-routing-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Jawg Maps (Location & Routing) 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 Jawg Maps. 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 Jawg Maps (Location & Routing) 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 Jawg Maps (Location & Routing) MCP in Mastra AI

You can. By adding `search_map_places` to your agent, Mastra AI can perform lookups as part of a multi-step task.

Yes, the framework handles retries for any tool call. If the connection to the server drops, Mastra AI attempts the call again based on your policy.

You use the requireToolApproval setting. This forces a human to confirm the agent's routing request before the server executes the action.

You use `search_country_filter`. It restricts the search scope to the specific region you define in your agent's instructions.

The server processes your latitude and longitude inputs ephemerally. It does not keep a persistent record of the coordinates you pass for routing.

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 Jawg Maps (Location & Routing) MCP today

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

Get started