Skip to content

Developer Documentation

EvenStance MCP API

Connect your AI assistant to EvenStance using the Model Context Protocol (MCP). Manage dispute cases, generate letters, sync email and calendar, upload to cloud storage, and more — all from Claude Desktop, ChatGPT, or any MCP-compatible client.

API Overview

EvenStance exposes a Model Context Protocol (MCP) endpoint that allows AI assistants to interact with the platform on your behalf. The API supports case management, letter generation, email and calendar synchronisation, cloud storage, e-signatures, company research, and more.

Endpoint
POST https://evenstance.com/api/mcp
Discovery

Auto-discovery is available at:

https://evenstance.com/.well-known/mcp.json

39

Tools

3

Resources

6

Providers

MCP

Protocol 2024-11-05

Authentication

All API requests require a Bearer token in the Authorization header.

How to get an API key

  1. Sign in to EvenStance and go to Settings
  2. Navigate to Connected Services
  3. Under MCP API Keys, click Create New Key
  4. Copy the key immediately — it is only shown once

Example request header

Authorization: Bearer es_mcp_your_api_key_here

Security note

API keys grant full access to your account. Never share your key or commit it to source control. You can revoke keys at any time from Settings.

Available Tools

The EvenStance MCP server exposes 39 tools across three categories: case management (internal), email/calendar/cloud (integration), and third-party services (ecosystem).

Case Management(12 tools)

list_cases

List all dispute cases for the authenticated user with status, category, and strength score.

get_case

Get detailed information about a specific case including timeline, documents, and communications.

create_case

Create a new dispute case with company, category, description, and claim value.

get_case_assessment

Get an AI-powered assessment of case strength, recommended next steps, and legal position.

generate_letter

Generate a formal complaint, escalation, or legal letter for a specific case.

add_communication

Log a communication (email, phone, letter) to the case timeline.

get_next_steps

Get personalised recommended next steps based on current case status and history.

search_companies

Search the UK company directory for contact details, complaints process, and escalation routes.

get_portfolio_stats

Get aggregate statistics across all your cases: win rate, active count, total value.

get_deadlines

List upcoming deadlines across all cases with urgency levels.

update_case_status

Update the status of a case (e.g., SUBMITTED, UNDER_REVIEW, ESCALATED).

get_company_reviews

Get Trustpilot and other review data for a company to support your case.

Email, Calendar & Cloud(10 tools)

import_outlook_emails

Import relevant emails from connected Outlook account, matched to cases by company.

send_via_outlook

Send a letter or message via connected Outlook email.

import_gmail_emails

Import relevant emails from connected Gmail account, matched to cases by company.

send_via_gmail

Send a letter or message via connected Gmail.

sync_deadlines_to_google_calendar

Sync case deadlines to Google Calendar with urgency colour coding.

import_google_calendar_events

Import calendar events related to your disputes.

sync_deadlines_to_outlook_calendar

Sync case deadlines to Outlook Calendar.

upload_to_drive

Upload documents and exports to connected Google Drive or OneDrive.

import_from_drive

Import evidence files from Google Drive or OneDrive.

generate_ical

Generate an iCal (.ics) file of all case deadlines for any calendar app.

Ecosystem & Third-Party Services(17 tools)

create_zoom_meeting

Create a Zoom meeting for consultation or mediation sessions.

create_teams_meeting

Create a Microsoft Teams meeting.

send_slack_message

Send a notification to a Slack channel.

send_whatsapp_message

Send a WhatsApp message via Business API.

export_case_to_notion

Export case data to a Notion database.

export_case_to_trello

Export case tasks to a Trello board.

send_for_signature

Send a document for e-signature via Adobe Sign or DocuSign.

check_signature_status

Check the status of a pending e-signature request.

get_trustpilot_reviews

Fetch Trustpilot reviews for a company.

get_tripadvisor_reviews

Fetch Tripadvisor reviews for a travel-related company.

lookup_company_house

Look up a company on Companies House (registration, directors, filings).

get_company_officers

Get the list of directors and officers for a company.

search_legislation

Search UK legislation on GOV.UK by keyword or Act name.

search_court_cases

Search published court judgments and case law.

get_regulator_info

Get regulator details, contact info, and complaint process.

search_parliament_bills

Search current and recent UK Parliament bills.

research_with_perplexity

Run a research query via Perplexity AI for up-to-date legal context.

Resources

MCP resources provide read access to your EvenStance data. AI assistants can query these URIs to understand your current cases, account, and connected services.

EvenStance://cases

User's dispute cases

All dispute cases belonging to the authenticated user

EvenStance://account

Account information

User profile and subscription details

EvenStance://integrations

Connected services

Status of external service connections

Rate Limits

100

requests per hour (default)

Per key

limits are scoped to each API key

Custom

limits can be set when creating a key

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709125200

Quick Start

Connect EvenStance to your preferred AI assistant in minutes.

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "evenstance": {
      "url": "https://evenstance.com/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

ChatGPT & Other MCP Clients

For clients that support MCP auto-discovery, point them at the discovery URL:

https://evenstance.com/.well-known/mcp.json

Direct API Call (cURL)

You can also call the MCP endpoint directly using JSON-RPC:

curl -X POST https://evenstance.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_cases",
      "arguments": {}
    }
  }'

Ready to get started?

Create your free EvenStance account, generate an API key, and connect your AI assistant in under five minutes.

Create AccountGenerate API Key