# HttpStatus MCP Server

24 AI-callable tools for API testing, mocking, monitoring, security, and automation — directly from your AI assistant.

**Remote URL:** `https://mcp.httpstatus.com/mcp`
**Transport:** Streamable HTTP
**Auth:** OAuth2 or Bearer token
**Documentation:** [httpstatus.com/mcp](https://httpstatus.com/mcp)

## Quick Setup

### Option 1: OAuth2 (recommended)

Clients that support OAuth2 (Claude, Cursor, etc.) will handle authentication automatically:

```json
{
  "mcpServers": {
    "httpstatus": {
      "url": "https://mcp.httpstatus.com/mcp"
    }
  }
}
```

### Option 2: Bearer Token

Generate an API key at [httpstatus.com/app/api-keys](https://httpstatus.com/app/api-keys) and pass it as a Bearer token:

```json
{
  "mcpServers": {
    "httpstatus": {
      "url": "https://mcp.httpstatus.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## Tools (24)

### API Mocking
- **create_mock** — Create an API mock endpoint with custom response, headers, and delay
- **update_mock** — Update an existing API mock by ID
- **delete_mock** — Delete an API mock by ID
- **list_mocks** — List API mocks with optional filtering and pagination

### Chaos Engineering
- **create_chaos_rule** — Create a chaos engineering rule for an API endpoint
- **disable_chaos_rule** — Disable a chaos rule by ID
- **list_chaos_rules** — List chaos engineering endpoint mappings

### Security & Validation
- **run_security_scan** — Scan a URL for security issues (headers, TLS, CORS, CSP, HSTS, XSS)
- **check_ssl** — Check SSL/TLS certificate validity, expiry, issuer chain, and protocols
- **validate_openapi** — Validate OpenAPI 2.x/3.x specification (JSON or YAML)
- **decode_jwt** — Decode JWT and return header, payload, and signature metadata

### Networking & Diagnostics
- **run_redirect_analyzer** — Analyze redirect chain behavior for a URL
- **run_cors_debug** — Run CORS diagnostics for a target URL and origin
- **run_trace** — Analyze distributed trace data (Jaeger, Zipkin, OpenTelemetry)
- **analyze_har** — Analyze HTTP Archive (HAR) file for performance and errors

### Monitoring
- **create_monitor** — Create uptime monitor for a URL with custom intervals and regions
- **get_monitor_status** — Get current status and uptime percentage for a monitor

### Automation Workflows
- **automation_create_workflow** — Create API automation workflow from defined steps
- **automation_generate_from_openapi** — Generate automation workflow from OpenAPI spec
- **automation_import_postman_collection** — Convert Postman collection to automation workflow
- **automation_run_workflow** — Run an existing automation workflow by ID
- **automation_get_workflow_status** — Get status, step results, and logs for a workflow run

### Utilities
- **capture_webhook** — Create and poll webhook capture bins for request inspection
- **start_resolve** — Resolve natural-language intent to HttpStatus.com tools

## Registry

Published on the official MCP registry:
`https://registry.modelcontextprotocol.io/v0.1/servers/com.httpstatus%2Fmcp-server/versions/0.1.0`

## License

MIT