LEAP Legal MCP Server for Mastra AI 18 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect LEAP Legal through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"leap-legal": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "LEAP Legal Agent",
instructions:
"You help users interact with LEAP Legal " +
"using 18 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with LEAP Legal?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About LEAP Legal MCP Server
Connect to LEAP Legal Software platform and manage your entire law practice from any AI agent. Access matters, contacts, documents, time entries, calendar events, bills, payments, and tasks—all through a unified REST API.
Mastra's agent abstraction provides a clean separation between LLM logic and LEAP Legal tool infrastructure. Connect 18 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Matters/Cases — List, search, create, and update legal matters with status, client, and practice area
- Contacts/Clients — Manage your client database including individuals, organizations, and opposing parties
- Client Portfolio — View all matters associated with a specific client
- Time Tracking — Log billable and non-billable time entries against any matter
- Bills/Invoices — List and review bills with amounts, status, and line items
- Payments — Track payments received from clients
- Tasks — View and manage tasks associated with matters and contacts
- Documents — Access matter documents, filings, correspondence, and evidence
- Calendar — View court dates, hearings, deadlines, and meetings
- Custom Fields — Access custom field schemas configured for matters
The LEAP Legal MCP Server exposes 18 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect LEAP Legal to Mastra AI via MCP
Follow these steps to integrate the LEAP Legal MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 18 tools from LEAP Legal via MCP
Why Use Mastra AI with the LEAP Legal MCP Server
Mastra AI provides unique advantages when paired with LEAP Legal through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add LEAP Legal without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every LEAP Legal tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
LEAP Legal + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the LEAP Legal MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query LEAP Legal, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed LEAP Legal as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query LEAP Legal on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using LEAP Legal tools alongside other MCP servers
LEAP Legal MCP Tools for Mastra AI (18)
These 18 tools become available when you connect LEAP Legal to Mastra AI via MCP:
create_leap_contact
USE WHEN: - User wants to add a new client - User needs to create a new contact record - User asks to "add a new client" or "create a contact" PARAMETERS: - first_name (REQUIRED): Client's first name - last_name (REQUIRED): Client's last name - email (OPTIONAL): Client's email address - phone (OPTIONAL): Client's phone number - type (OPTIONAL): Contact type — "Client" (default), "Opposing Party", "Witness", "Other" EXAMPLES: - "Add a new client John Smith" → call with first_name="John", last_name="Smith" - "Create contact for opposing party Jane Doe, jane@example.com" → call with first_name="Jane", last_name="Doe", email="jane@example.com", type="Opposing Party" Create a new contact/client in LEAP Legal
create_leap_matter
USE WHEN: - User wants to open a new legal case - User needs to create a new matter for a client - User asks to "create a new case" or "open a matter" PARAMETERS: - name (REQUIRED): Matter/case name - contact_id (OPTIONAL): ID of the client/contact this matter belongs to - status (OPTIONAL): Initial status — "Open" (default), "Closed", "Pending" - practice_area (OPTIONAL): Practice area (e.g. "Family Law", "Criminal Defense") - description (OPTIONAL): Matter description/notes EXAMPLES: - "Create a new matter called 'Smith Divorce'" → call with name="Smith Divorce" - "Open a new criminal defense matter for client 456" → call with name="State v. Johnson", contact_id="456", practice_area="Criminal Defense" Create a new matter/case in LEAP Legal
create_leap_time_entry
USE WHEN: - User wants to log time spent on a matter - User needs to record billable hours - User asks to "add time entry" or "log hours" PARAMETERS: - matter_id (REQUIRED): Matter/case ID this time entry belongs to - description (REQUIRED): Description of the work performed - duration_minutes (REQUIRED): Duration in minutes - billable (OPTIONAL): Whether this is billable — true (default) or false - rate (OPTIONAL): Hourly rate for this entry EXAMPLES: - "Log 2 hours of legal research for matter 123" → call with matter_id="123", description="Legal research", duration_minutes=120 - "Add 30 minute phone call with client" → call with matter_id="123", description="Phone call with client", duration_minutes=30 Create a new time entry for billing
get_client_leap_matters
Useful for understanding a client's full legal portfolio. Get all matters/cases for a specific client/contact
get_leap_bill
Get detailed information for a specific bill/invoice
get_leap_contact
Get detailed information for a specific contact/client
get_leap_matter
Get detailed information for a specific matter/case
list_leap_bills
List bills/invoices in LEAP Legal
list_leap_calendar_events
List calendar events in LEAP Legal
list_leap_contacts
USE WHEN: - User wants to see all their clients and contacts - User needs to find a client by name or email - User is exploring their contact database - User asks "list my clients" or "show all contacts" PARAMETERS: - page (OPTIONAL): Page number for pagination - page_size (OPTIONAL): Results per page (default: 25, max: 100) EXAMPLES: - "List all my clients" → call with no params - "Show my contacts" → call with no params - "List contacts page 2" → call with page="2" List all contacts/clients in LEAP Legal
list_leap_custom_fields
List custom field schemas in LEAP Legal
list_leap_documents
List documents for a specific matter
list_leap_matters
Supports filtering by status, client, practice area, and date range for flexible queries. USE WHEN: - User wants to see all their legal matters/cases - User needs to find matters by status, client, or practice area - User is exploring their law firm's caseload - User asks "what matters do I have" or "list my open cases" PARAMETERS: - status (OPTIONAL): Filter by matter status (e.g. "Open", "Closed", "Pending") - practice_area (OPTIONAL): Filter by practice area (e.g. "Family Law", "Criminal Defense") - contact_id (OPTIONAL): Filter by specific client/contact ID - page (OPTIONAL): Page number for pagination - page_size (OPTIONAL): Results per page (default: 25, max: 100) EXAMPLES: - "List all my open matters" → call with status="Open" - "Show my family law matters" → call with practice_area="Family Law" - "List all matters" → call with no params List all matters/cases in LEAP Legal Software
list_leap_payments
List payments received in LEAP Legal
list_leap_tasks
List tasks in LEAP Legal
list_leap_time_entries
Supports filtering by matter, user, and date range. USE WHEN: - User wants to see all logged time entries - User needs to review billable hours for a matter - User is preparing invoices or reviewing time reports - User asks "show my time entries" or "list billable hours" PARAMETERS: - matter_id (OPTIONAL): Filter by specific matter ID - date_from (OPTIONAL): Start date filter (YYYY-MM-DD) - date_to (OPTIONAL): End date filter (YYYY-MM-DD) - page (OPTIONAL): Page number for pagination - page_size (OPTIONAL): Results per page (default: 25, max: 100) EXAMPLES: - "List all time entries" → call with no params - "Show time entries for matter 123" → call with matter_id="123" - "List time entries from April 1-7" → call with date_from="2026-04-01", date_to="2026-04-07" List time entries in LEAP Legal
search_leap_matters
Search matters/cases by keyword query
update_leap_matter
Update an existing matter/case in LEAP Legal
Example Prompts for LEAP Legal in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with LEAP Legal immediately.
"List all my open matters in LEAP Legal."
"Create a new time entry for 2 hours of legal research on the Smith Divorce matter."
"Show me all contacts for client John Smith."
Troubleshooting LEAP Legal MCP Server with Mastra AI
Common issues when connecting LEAP Legal to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpLEAP Legal + Mastra AI FAQ
Common questions about integrating LEAP Legal MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect LEAP Legal with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect LEAP Legal to Mastra AI
Get your token, paste the configuration, and start using 18 tools in under 2 minutes. No API key management needed.