How to Use the Nansen (Blockchain Analytics) MCP in Mastra AI

Q: How do I connect the Nansen (Blockchain Analytics) MCP Server to a Mastra AI agent?

You install the @mastra/mcp package and instantiate the MCPClient, passing your Vinkius server URL. Then you call mcpClient.listTools() and provide the result to your Mastra agent's tool configuration. Mastra handles the tool invocation from there.

Q: Can my agent require approval before executing a Nansen tool?

Yes. Mastra AI supports requireToolApproval. You can configure your agent so that before it calls a specific Nansen tool, like one that costs more credits, it pauses and waits for a human to approve the action. This is great for building semi-autonomous systems.

Build resilient, automated on-chain agents with Mastra AI. Connect to Nansen's data to create workflows that monitor, analyze, and act on market events.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nansen (Blockchain Analytics) MCP to Mastra AI

Create your Vinkius account to connect Nansen (Blockchain Analytics) 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 Nansen (Blockchain Analytics) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create Conditional Alerting Workflows

Build agents that do more than just fetch data. With Mastra AI, you can create logic that reacts to on-chain events. It’s not just an alert; it’s an automated response. For example, an agent can monitor `tgm_transfers`. If a large transfer is detected, it checks the sender's labels with `profiler_premium_labels`. If the 'Smart Money' label is present, the agent sends a detailed alert; otherwise, it ignores the event. Mastra's engine handles the if/then logic automatically.

Automate Deep-Dive Wallet Analysis

Chain multiple Nansen tools together to build a comprehensive analysis pipeline. Your agent can perform research that would take a human analyst hours, and it does it in seconds. A Mastra AI workflow can start with a wallet address, fetch the `profiler_pnl_summary`, and if the PnL is above a certain threshold, it can then trigger a deeper analysis using `profiler_related_wallets` and `profiler_counterparties`. This creates an efficient, multi-step investigation process.

Build a Resilient Mastra AI Agent

Network hiccups and API failures happen. Mastra AI is built to handle them so your on-chain automations don't break. Your agent keeps running even when the network is unreliable. If a call to `smart_money_dex_trades` fails, Mastra's built-in exponential backoff will retry the request. You don't need to write custom error-handling code for every tool call. This makes your Nansen MCP integration much more reliable.

Setup guide

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

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

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

You install the `@mastra/mcp` package and instantiate the `MCPClient`, passing your Vinkius server URL. Then you call `mcpClient.listTools()` and provide the result to your Mastra agent's tool configuration. Mastra handles the tool invocation from there.

Yes. Mastra AI supports `requireToolApproval`. You can configure your agent so that before it calls a specific Nansen tool, like one that costs more credits, it pauses and waits for a human to approve the action. This is great for building semi-autonomous systems.

You could build a token due-diligence agent. It could take a token contract, use `tgm_token_information` to get metadata, check `tgm_flow_intelligence` for exchange flows, and then use `tgm_who_bought_sold` to analyze recent buyer activity, summarizing it all in a report.

Mastra AI has built-in features like automatic retries with exponential backoff. This helps your agent gracefully handle rate-limiting errors from the server without crashing, making your automations more robust.

Your agent, running in your own environment, will process any on-chain data you request from the Nansen tools. This includes wallet addresses, transaction histories, and PnL data. Your Vinkius MCP endpoint token is the only credential needed, keeping your actual Nansen keys secure.

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