How to Use the Geocode.xyz MCP in Mastra AI

Q: How do I add Geocode.xyz to a Mastra AI agent?

Install @mastra/mcp@latest and configure the client with the Vinkius endpoint URL. Call mcpClient.listTools() and spread the resulting array into your agent's tools configuration.

Q: Can I require human approval for Geocode.xyz reverse geocoding?

You can flag the reversegeocode tool with requireToolApproval in Mastra AI. The workflow will pause and wait for a manual confirmation before converting those coordinates into a physical address.

Add resilient location logic to Mastra AI workflows. Run Geocode.xyz lookups with automatic retries and exponential backoff.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Geocode.xyz MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build reliable Geocode.xyz workflows

This MCP Server feeds geographic data into your automated pipelines. The `forward_geocode` tool converts place names into coordinates, allowing your Mastra AI agents to route physical deliveries or map out service areas. Network requests fail, especially with external APIs. Mastra's built-in engine wraps these tool calls in conditional branches. If a lookup times out, the framework automatically retries with exponential backoff before notifying an admin.

Parse messy address data at scale

The `geoparse` tool extracts specific location entities from massive blocks of unstructured text. You can feed a 5,000-word customer complaint log into the tool, and it uses a POST request under the hood to handle the payload length. Your agent takes that extracted data and passes it to downstream tasks. Setup takes one command using `new MCPClient()` and pointing it at the Vinkius URL.

Integrate IP lookups via MCP Server

You can trigger the `ip_geolocation` tool to find where a specific network request originated. When a suspicious login occurs, your agent grabs the IP, finds the country, and compares it against known user behavior. If the location looks wrong, you can require human approval. Mastra supports `requireToolApproval`, so the agent pauses the workflow until a security engineer reviews the flagged region.

Setup guide

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

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

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

Install `@mastra/mcp@latest` and configure the client with the Vinkius endpoint URL. Call `mcpClient.listTools()` and spread the resulting array into your agent's tools configuration.

Yes, Mastra's workflow engine manages failures automatically. You can configure exponential backoff rules so the agent slows down its requests if the API returns a rate limit error.

You can flag the `reverse_geocode` tool with `requireToolApproval` in Mastra AI. The workflow will pause and wait for a manual confirmation before converting those coordinates into a physical address.

The framework auto-detects the best connection method. For Vinkius-hosted servers, it defaults to Streamable HTTP, but it can fall back to SSE if your deployment environment requires it.

This setup processes sensitive user IPs and exact latitude/longitude coordinates. Vinkius isolates every single request in an ephemeral zero-trust environment, dropping all memory states the second the TCP connection closes.

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