What features of MyCase are available through this API?

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

How do I get a MyCase API key?

Log in to your MyCase account at mycase.com, navigate to Settings → API or Integrations, and generate an API key. The key gives you access to your firm's case data, client information, time entries, and billing data. Contact MyCase support if you don't see the API option in your account.

Can I create new cases and clients through the API?

Yes! You can create new matters/cases with title, client assignment, status, and practice area. You can also create new contacts/clients with name, email, phone, and contact type (client, opposing party, witness, etc.). Use `create_mycase_matter` and `create_mycase_contact` tools for these operations.

How do I track billable time with MyCase API?

Use `create_mycase_time_entry` to log time against any case. 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_mycase_time_entries` to view all time logged against a specific case.

MyCase Legal MCP Server for OpenAI Agents SDK 16 tools — connect in under 2 minutes

Name: MyCase Legal
Availability: InStock
Author: Vinkius

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

Built by Vinkius GDPR 16 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect MyCase 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="MyCase Legal Assistant",
            instructions=(
                "You help users interact with MyCase Legal. "
                "You have access to 16 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from MyCase 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 MyCase Legal MCP Server

Connect to MyCase legal practice management platform and manage your entire law practice from any AI agent. Access cases/matters, clients, documents, time entries, calendar events, invoices, and payments—all through a unified API.

The OpenAI Agents SDK auto-discovers all 16 tools from MyCase Legal through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries MyCase 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 cases with status, practice area, and client info
Contacts/Clients — Manage your client database including name, email, phone, and address
Client Portfolio — View all cases associated with a specific client
Documents — Access case documents, filings, correspondence, and evidence
Time Tracking — Log billable and non-billable time entries against any case
Calendar — View court dates, hearings, deadlines, and meetings
Invoices — List and review invoices with amounts, status, and line items
Payments — Track payments received from clients
Search — Search cases by keyword across titles, client names, and descriptions

The MyCase Legal MCP Server exposes 16 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 MyCase Legal to OpenAI Agents SDK via MCP

Follow these steps to integrate the MyCase 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 16 tools from MyCase Legal

Why Use OpenAI Agents SDK with the MyCase Legal MCP Server

OpenAI Agents SDK provides unique advantages when paired with MyCase 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

MyCase Legal + OpenAI Agents SDK Use Cases

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

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

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

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

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

MyCase Legal MCP Tools for OpenAI Agents SDK (16)

These 16 tools become available when you connect MyCase Legal to OpenAI Agents SDK via MCP:

create_mycase_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: - given_name (REQUIRED): Client's first name - family_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 given_name="John", family_name="Smith" - "Create contact for opposing party Jane Doe, jane@example.com" → call with given_name="Jane", family_name="Doe", email="jane@example.com", type="opposing_party" Create a new contact/client in MyCase

create_mycase_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: - title (REQUIRED): Matter/case title - client_id (REQUIRED): ID of the client this matter belongs to - status (OPTIONAL): Initial status — "open" (default), "closed", "archived", "on_hold" - practice_area (OPTIONAL): Practice area (e.g. "Family Law", "Criminal Defense") - description (OPTIONAL): Matter description/notes EXAMPLES: - "Create a new case for client 123 titled 'Smith Divorce'" → call with title="Smith Divorce", client_id="123" - "Open a new criminal defense matter for client 456" → call with title="State v. Johnson", client_id="456", practice_area="Criminal Defense" Create a new case/matter in MyCase

create_mycase_time_entry

USE WHEN: - User wants to log time spent on a case - 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 research for case 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_mycase_cases

Useful for understanding a client's full legal portfolio. Get all cases/matters for a specific client

get_mycase_contact

Get detailed information for a specific contact/client

get_mycase_invoice

Get detailed information for a specific invoice

get_mycase_matter

Get detailed information for a specific case/matter

list_mycase_calendar_events

List calendar events for the law firm

list_mycase_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 clients page 2" → call with page="2" List all contacts/clients in MyCase

list_mycase_documents

List documents for a specific case/matter

list_mycase_invoices

List invoices for the law firm

list_mycase_matters

Essential for case management and tracking. USE WHEN: - User wants to see all their legal cases/matters - User needs to find cases by status (open, closed, archived, on hold) - User is exploring their law firm's caseload - User asks "what cases do I have" or "list my open matters" PARAMETERS: - status (OPTIONAL): Filter by status — "open", "closed", "archived", "on_hold" - practice_area (OPTIONAL): Filter by practice area (e.g. "Family Law", "Criminal Defense") - client_id (OPTIONAL): Filter by specific client ID - page (OPTIONAL): Page number for pagination - page_size (OPTIONAL): Results per page (default: 25, max: 100) EXAMPLES: - "List all my open cases" → call with status="open" - "Show my family law matters" → call with practice_area="Family Law" - "List all matters" → call with no params List all cases/matters in MyCase legal practice management

list_mycase_payments

List payments received by the law firm

list_mycase_time_entries

List time entries for a specific case/matter

search_mycase_matters

Search cases/matters by keyword query

update_mycase_matter

Update an existing case/matter in MyCase

Example Prompts for MyCase Legal in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with MyCase Legal immediately.

"List all my open cases in MyCase."

"Create a new time entry for 2 hours of legal research on the Smith Divorce case."

"Show me all cases for client John Smith."

Troubleshooting MyCase Legal MCP Server with OpenAI Agents SDK

Common issues when connecting MyCase 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.

MyCase Legal + OpenAI Agents SDK FAQ

Common questions about integrating MyCase 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.