How to Use the MapQuest MCP in Mastra AI

Q: How do I add MapQuest tools to a Mastra AI agent?

Initialize the MCP client using @mastra/mcp and call mcpClient.listTools() to load MapQuest. You can then spread these MapQuest tools directly into your Mastra AI agent configuration to instantly expose getdirections.

Q: Can I require human approval before calling MapQuest routing tools in Mastra AI?

Yes, you can set requireToolApproval on your Mastra AI agent for MapQuest's getdirections. This pauses the Mastra AI workflow and waits for a human to confirm the route before hitting the MapQuest API.

Build resilient, multi-step location workflows by connecting MapQuest tools to your Mastra AI agents via this 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 MapQuest MCP to Mastra AI

Create your Vinkius account to connect MapQuest 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 MapQuest with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build branching MapQuest routing workflows in Mastra AI

The `get_directions` tool integrates directly into Mastra AI workflows, letting you build conditional logic based on MapQuest travel times. If a MapQuest route exceeds a specific duration, your Mastra AI workflow automatically branches to find alternative stops. This structure ensures your Mastra AI delivery agents make decisions based on real-time MapQuest transit data. You define the routing steps in TypeScript, and Mastra AI executes them sequentially depending on traffic conditions.

Auto-retry MapQuest local POI searches with this MCP Server

The `search_points_of_interest` tool lets your Mastra AI agent find nearby amenities like gas stations or restaurants around MapQuest coordinates. If the initial MapQuest search yields zero results, Mastra AI's built-in retry engine backs off and triggers a wider search automatically. You don't have to write custom loop or retry logic to handle MapQuest API timeouts. The Mastra AI agent uses the tool to gather local data, ensuring your automated travel guides always have accurate spot listings.

Multi-step address validation with Mastra AI

The `geocode_address` and `reverse_geocode` tools work together inside your Mastra AI agents to check messy shipping data. Your agent first geocodes the input address via MapQuest, then reverse-geocodes the coordinates to double-check against databases. If the two MapQuest results do not match, the Mastra AI workflow flags the order for human approval. This automated validation loop protects your Mastra AI logistics pipeline from shipping to non-existent locations.

Setup guide

Set up MapQuest 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 MapQuest 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: "mapquest-mcp-client",
  servers: {
    "mapquest-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent MapQuest 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 MapQuest. 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 MapQuest 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 MapQuest MCP in Mastra AI

Initialize the MCP client using `@mastra/mcp` and call `mcpClient.listTools()` to load MapQuest. You can then spread these MapQuest tools directly into your Mastra AI agent configuration to instantly expose `get_directions`.

Yes, you can set `requireToolApproval` on your Mastra AI agent for MapQuest's `get_directions`. This pauses the Mastra AI workflow and waits for a human to confirm the route before hitting the MapQuest API.

Use Mastra AI's workflow engine to configure exponential backoff retries for your MapQuest location calls. If `search_points_of_interest` hits a rate limit, Mastra AI pauses and retries without failing the entire run.

The Mastra AI client automatically detects the transport type, whether it is Streamable HTTP or SSE. You only need to provide the Vinkius endpoint URL to start querying MapQuest coordinates inside Mastra AI.

Address strings and raw coordinates sent from Mastra AI are processed in an ephemeral V8 sandbox. They are transmitted securely to MapQuest for resolution and are never cached or written to persistent storage by Mastra AI.

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