How to Use the FinLegal MCP in Mastra AI

Q: Can I use Mastra AI workflows to automate FinLegal activities?

Yes, you can map tools like createactivity and listactivities into a Mastra workflow. This allows you to build conditional branches that trigger specific legal steps based on the current claim status.

Q: How do I configure administrator contacts?

When calling createcontact, pass isAdministrator=true in the arguments. This flags the contact as a claim manager, giving them the correct permissions for managing cases.

Build resilient legal finance agents with Mastra AI and the FinLegal MCP Server to automate litigation funding.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FinLegal MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate legal workflows with Mastra AI

Litigation funding is a game of steps, and running `create_activity` ensures every milestone is logged. This MCP Server gives Mastra AI agents the tools to run multi-step legal workflows without dropping the ball. If a step fails, Mastra's built-in workflow engine retries the call with exponential backoff. Your team never loses critical updates to `update_contact` or new records created with `create_claim` due to momentary network hiccups.

Human-in-the-loop claim approvals

You don't want an AI approving a million-dollar litigation fund, so wrap `create_claim` in a manual approval step. The Mastra AI agent gathers the case details using `get_case` and prepares the data. It pauses execution, sends a Slack ping to your risk officer, and only writes the claim once a human clicks approve. This keeps your risk management tight without slowing down onboarding.

Smart contact deduplication

Law firms struggle with messy contact databases, but `get_contact_by_email` helps you find existing claimants first. If the contact is found, the agent pulls their details with `get_contact` and updates their file using `update_contact`. For entirely new contacts, the agent creates a fresh record and registers them as an admin or claimant. This prevents duplicate records from cluttering your case management system.

Setup guide

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

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

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

Instantiate the MCP client with your Vinkius HTTP endpoint. Call `mcpClient.listTools()` and spread the result directly into the tools array of your Mastra AI agent to give it immediate access to `list_claims` and `get_case`.

Yes, you can map tools like `create_activity` and `list_activities` into a Mastra workflow. This allows you to build conditional branches that trigger specific legal steps based on the current claim status.

Mastra's workflow engine manages rate limits through built-in retry logic. If an MCP tool like `list_attribute_templates` hits an API limit, the agent waits and retries automatically, keeping your legal pipeline running.

When calling `create_contact`, pass `isAdministrator=true` in the arguments. This flags the contact as a claim manager, giving them the correct permissions for managing cases.

All litigation funding data, including emails retrieved via `get_contact_by_email`, is processed within Vinkius's secure MCP runtime. No claim data is cached on disk, and communication uses secure, encrypted SSE or HTTP transports.

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