@formstatus/mcp

Connect your FormStatus account to any MCP-compatible AI assistant (Claude Desktop, Cursor, etc.) to monitor form health, diagnose failures, and trigger test runs — all through natural language.

Quick Start

1. Get your API key

Log into your FormStatus account → Account Settings → API Keys → Generate Key.

2. Configure your AI client

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "formstatus": {
      "command": "npx",
      "args": ["-y", "@formstatus/mcp"],
      "env": {
        "FORMSTATUS_API_KEY": "1|your-api-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "formstatus": {
      "command": "npx",
      "args": ["-y", "@formstatus/mcp"],
      "env": {
        "FORMSTATUS_API_KEY": "1|your-api-key-here"
      }
    }
  }
}

Any MCP-compatible client

{
  "mcpServers": {
    "formstatus": {
      "command": "npx",
      "args": ["-y", "@formstatus/mcp"],
      "env": {
        "FORMSTATUS_API_KEY": "1|your-api-key-here"
      }
    }
  }
}

3. Start asking

• "What forms are currently failing?"
• "Why is my contact form on example.com failing?"
• "Show me the health overview of all my monitored forms"
• "Run a test on form 39"

Available Tools

| Tool | Description | |------|-------------| | list_forms | List all monitored forms (filterable by status) | | get_form | Get details about a specific form | | get_form_checks | Get check history for a form | | get_form_report | Get full diagnostic report for a check | | get_dashboard | Dashboard overview with metrics and trends | | get_failed_forms | List currently failing forms | | diagnose_form | Comprehensive diagnostic for a single form | | trigger_test | Trigger a manual test run |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FORMSTATUS_API_KEY | Yes | — | Your API key from FormStatus settings | | FORMSTATUS_API_URL | No | https://app.formstatus.co | API base URL (change for self-hosted/staging) |

Local Development

# Install dependencies
npm install

# Build
npm run build

# Run with local API
FORMSTATUS_API_KEY="your-key" \
FORMSTATUS_API_URL="http://localhost:8080" \
node dist/index.js

Security

• Your API key is scoped to your account only
• Keys are read-only (can view data) plus test-trigger capability
• You can revoke keys at any time from your FormStatus settings
• No other users' data is accessible