How to Use the KnowFirst MCP in Mastra AI

Build resilient data intelligence workflows that automatically query entities and audit changes with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KnowFirst MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create Failsafe Intelligence Pipelines

Build a Mastra AI workflow that won't quit. Start by using `check_knowfirst_api_status` to confirm the API is up. If it's down, Mastra's engine can automatically retry with exponential backoff before alerting you. From there, have your agent `search_intelligence_entities`. If the query fails, you can branch your logic to try a broader search or log the failure. This is how you build reliable, automated data gathering without manual intervention.

Automate Due Diligence with Mastra AI

Set up a multi-step agent that performs background checks. First, it uses `get_entity_profile` to pull the main details. Then, it calls `list_entity_data_points` to get the raw signals and `audit_entity_changes` for a full history. Mastra AI makes this sequence easy to define as a single workflow. If any step fails, like a timeout on a large audit log, the agent can retry that specific step or escalate to a human for review.

Branching Logic for Custom KnowFirst Queries

The `query_custom_intelligence` tool is powerful, but queries can be complex. With Mastra AI, you can build conditional logic around it. If an initial narrow query returns no results, the workflow can automatically branch to a broader one. This saves a ton of time. You're not just running a script; you're deploying a smart agent that adapts. This MCP server provides the data tools, and Mastra provides the brain to use them intelligently.

Setup guide

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

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

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

Mastra AI has built-in retry mechanisms. Wrap your KnowFirst tool calls, like `get_market_intelligence_trends`, in a step with a retry policy. The agent will handle transient network issues or API hiccups for you.

Absolutely. Create a workflow that iterates through a list of entity IDs. In each loop, it calls `audit_entity_changes` and `get_entity_profile` to check for updates, then sends a notification if anything has changed.

Yes, Mastra AI supports human-in-the-loop workflows. You can configure a step that uses `query_custom_intelligence` to first require approval before executing. This ensures you don't run expensive or sensitive operations by accident.

Resilience and state management. A simple script will crash on an error. A Mastra AI agent using the KnowFirst tools can manage failures, retry operations, and execute complex conditional logic that simple scripts can't handle.

The server is ephemeral and stateless. It processes your requests—like search terms for `search_intelligence_entities` or custom JSON for `query_custom_intelligence`—but doesn't store them. Vinkius ensures each request is handled in a zero-trust, isolated sandbox.

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