Maeris logo
Get started for free

Maeris MCP

Maeris MCP is a Model Context Protocol server that connects your AI editor directly to your codebase. Describe what you want tested — UI flows, APIs, security, GDPR — and Maeris handles everything end to end.

What is Maeris MCP?

Maeris MCP exposes 60+ tools to your AI assistant (Cursor, Claude Code, Codex) via the Model Context Protocol. Once installed, you can ask your editor to generate tests, scan APIs, run security checks, and push results to your Maeris dashboard — all in plain English, without leaving your editor.

What you can do

  • Generate Playwright tests from your source code — no scripts to write
  • Auto-fix failing tests — Maeris inspects the error, patches, and reruns
  • Extract every API endpoint from your codebase into organised collections
  • Run OWASP Top 10 security scans, GDPR checks, and accessibility audits
  • Push all results to your Maeris portal for team visibility

Requirements

Installation

Step 1 — Install the package

Install Maeris from PyPI using pip:

$ pip install maeris

Step 2 — Initialise in your project

Navigate to your project root and run:

$ maeris app init

This creates a .mcp.json file in your project root and registers the Maeris MCP server with your editor. The config looks like this:

{
  "mcpServers": {
    "maeris": {
      "command": "maeris",
      "args": ["serve"]
    }
  }
}

Step 3 — Restart your editor

Restart Cursor, Claude Code, or Codex. Your editor will automatically detect the .mcp.json config and load the Maeris tools. You should see Maeris appear in your MCP tools list.

Step 4 — Ask in plain English

You're ready. Try asking your editor:

"Generate E2E tests for my checkout flow"

"Scan my API for security vulnerabilities"

"Extract all API endpoints from my codebase"

What gets created

After running maeris app init, two things are created in your project:

  • .mcp.json — MCP server configuration, auto-managed by Maeris
  • .maeris/ — Local state directory storing tests, API collections, scan results, and credentials per project

Available capabilities

Maeris MCP exposes tools across six areas:

UI Testing

  • Generate Playwright tests from source code
  • Run tests and auto-fix broken selectors on failure
  • Push test results to your Maeris dashboard
  • Analyse test patterns and coverage gaps

API Discovery & Testing

  • Scan your codebase and extract every API endpoint automatically
  • Create and manage API collections and sub-collections
  • Build multi-step API flows with data chaining between requests
  • Manage environments (local, staging, production)
  • Add assertions, run collections, export as Postman

Security Scanning

  • OWASP Top 10 static analysis
  • Secrets detection — API keys, tokens, credentials in source
  • API-level security scanning
  • Dependency and container vulnerability checks

GDPR & Accessibility

  • GDPR scan — pre-consent cookies, PII in storage, third-party trackers
  • WCAG 2.1 / 2.2 accessibility audit — colour contrast, ARIA, keyboard navigation
  • Spell and grammar scan across all UI text
  • Push compliance reports to Maeris portal

Test Management

  • Create and manage test folders and test cases
  • Import, edit, and run test cases from your editor
  • Search and filter test cases across your project

Portal Sync

  • Authenticate with your Maeris portal account
  • Push tests, scan results, and API collections to the dashboard
  • Switch between applications / projects

Syncing with the Maeris portal

Everything generated through MCP is automatically pushed to your Maeris portal. Your whole team — QA, dev, PM — can view results, manage schedules, and track coverage without needing the editor.

Visit light.maeris.io to view your dashboard.

Next steps