What features of LEAP Legal are available through this API?

The API provides access to: Matters/Cases (CRUD operations), Contacts/Clients (create and list), Time Entries (list and create), Bills/Invoices (list and get), Payments (list), Tasks (list), Documents (list by matter), Calendar Events (list), and Custom Fields (list schemas). You can search matters by keyword, filter by status and practice area, and view all matters for a specific client.

How do I get a LEAP Legal API access token?

Visit the LEAP Developer Console at developer.leap.build and register your application. Use OAuth 2 authentication to obtain an access token. The token is used as a Bearer token in the Authorization header for all API requests. Contact LEAP support if you need help setting up API access for your firm.

Can I create new matters and contacts through the API?

Yes! You can create new matters with name, client assignment, status, and practice area. You can also create new contacts with first name, last name, email, phone, and contact type (Client, Opposing Party, Witness, etc.). Use `create_leap_matter` and `create_leap_contact` tools for these operations.

How do I track billable time with LEAP Legal API?

Use `create_leap_time_entry` to log time against any matter. Provide the matter ID, description of work, and duration in minutes. You can specify whether the entry is billable and set a custom hourly rate. Use `list_leap_time_entries` to view all time logged against a specific matter or across all matters.

LEAP Legal MCP Server for OpenAI Agents SDK 18 tools — connect in under 2 minutes

Name: LEAP Legal
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 18 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect LEAP Legal through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="LEAP Legal Assistant",
            instructions=(
                "You help users interact with LEAP Legal. "
                "You have access to 18 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from LEAP Legal"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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.

The OpenAI Agents SDK auto-discovers all 18 tools from LEAP Legal through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries LEAP Legal, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

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 OpenAI Agents SDK 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 OpenAI Agents SDK via MCP

Follow these steps to integrate the LEAP Legal MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 18 tools from LEAP Legal

Why Use OpenAI Agents SDK with the LEAP Legal MCP Server

OpenAI Agents SDK provides unique advantages when paired with LEAP Legal through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

LEAP Legal + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the LEAP Legal MCP Server delivers measurable value.

Automated workflows: build agents that query LEAP Legal, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries LEAP Legal, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through LEAP Legal tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query LEAP Legal to resolve tickets, look up records, and update statuses without human intervention

LEAP Legal MCP Tools for OpenAI Agents SDK (18)

These 18 tools become available when you connect LEAP Legal to OpenAI Agents SDK 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 OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK

Common issues when connecting LEAP Legal to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

LEAP Legal + OpenAI Agents SDK FAQ

Common questions about integrating LEAP Legal MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.