How to Use the AbstractAPI MCP in Mastra AI

Q: How do I register AbstractAPI tools with my Mastra AI agent?

Install @mastra/mcp and instantiate the client with your Vinkius endpoint URL. Call mcpClient.listTools() and spread them directly into your agent's tool array. Your workflow engine gains instant access to all capabilities.

Q: Can I require human approval before running AbstractAPI tools in Mastra AI?

Yes, you can configure requireToolApproval in your workflow definition. This pauses execution when tools like validatevat run, letting a human verify the company details first. The workflow resumes once approved.

Q: What security measures protect the VAT and phone data sent to this MCP Server?

All phone numbers and VAT IDs processed by validatephone and validatevat run inside isolated sandboxes. Vinkius secures these payloads using TLS 1.3 encryption in transit. No persistent logs of this sensitive business data are ever created.

Build self-healing workflows with Mastra AI that validate contacts, check exchange rates, and locate users automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AbstractAPI MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run automated contact verification loops

`validate_email` checks MX records and SMTP status to verify if an inbox actually exists. Your Mastra AI agent triggers this tool inside a workflow step to clean email lists. If validation fails, the workflow branches to flag the lead. Next, `validate_phone` determines carrier details and line types for incoming signups. It ensures your automated SMS campaigns only target active mobile numbers. The workflow engine handles these checks sequentially, logging errors automatically.

Handle global billing with this Mastra AI MCP Server setup

`validate_vat` checks EU VAT numbers against official databases to verify corporate tax status. Your workflow uses this tool to approve B2B accounts before creating invoices. It stops fraud at the signup stage. Simultaneously, `exchange_rate` pulls real-time conversion rates to adjust pricing dynamically. Your agent uses this data to convert checkout totals into the customer's local currency. You avoid manual exchange calculation errors entirely.

Capture pages and map locations

`website_screenshot` spins up a headless browser to capture full-page images of target URLs. Your agent uses the resulting permanent URL to archive landing pages for compliance audits. The workflow saves these assets directly to your storage bucket. Along with this, `geolocate_ip` resolves IP addresses to extract timezone, ISP, and regional currency data. Mastra workflows use this tool to route customer service tickets to the correct regional team. It ensures local support agents handle urgent requests.

Setup guide

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

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

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

Install `@mastra/mcp` and instantiate the client with your Vinkius endpoint URL. Call `mcpClient.listTools()` and spread them directly into your agent's tool array. Your workflow engine gains instant access to all capabilities.

Yes, you can configure `requireToolApproval` in your workflow definition. This pauses execution when tools like `validate_vat` run, letting a human verify the company details first. The workflow resumes once approved.

Absolutely. If a rate limit or network glitch occurs during a `geolocate_ip` call, Mastra automatically retries the operation. It uses exponential backoff to ensure your workflow completes successfully.

Your agent automatically extracts the domain name from conversation context and passes it to this MCP Server tool. The tool returns structured JSON containing employee counts and industry classification. Your workflow uses this data for immediate branching decisions.

All phone numbers and VAT IDs processed by `validate_phone` and `validate_vat` run inside isolated sandboxes. Vinkius secures these payloads using TLS 1.3 encryption in transit. No persistent logs of this sensitive business data are ever created.

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