murphys-laws-mcp

A Model Context Protocol (MCP) server that gives AI agents access to 1,500+ Murphy's Laws, corollaries, and humorous observations about life's tendency for things to go wrong.

Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP-compatible host.

Quick Start

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "murphys-laws": {
      "command": "npx",
      "args": ["-y", "murphys-laws-mcp"]
    }
  }
}

That's it. No API key, no database, no setup.

Tools

| Tool | Description | |------|-------------| | search_laws | Search laws by keyword with optional category filter | | get_random_law | Get a random Murphy's Law | | get_law_of_the_day | Get today's featured law (rotates daily) | | get_law | Get a specific law by ID | | list_categories | List all 55 categories with slugs and law counts | | get_laws_by_category | Browse laws in a specific category | | submit_law | Submit a new law for review |

Example Usage

Once connected, you can ask your AI assistant things like:

• "What's today's Murphy's Law?"
• "Find Murphy's Laws about computers"
• "Give me a random Murphy's Law"
• "Browse the military laws category"
• "Submit a new Murphy's Law: 'The printer will always jam when you're in a hurry'"

Configuration

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MURPHYS_API_URL | https://murphys-laws.com | Base URL for the Murphy's Laws API |

Local Development

If running from the monorepo source:

cd mcp
npm install
npm start          # Run the server
npm run dev        # Run with watch mode
npm run inspect    # Open MCP Inspector

API

This MCP server uses the public Murphy's Laws REST API. No authentication required for reads. Rate limits apply only to writes (3 law submissions/minute).

• API Docs
• OpenAPI Spec
• llms.txt

License

CC0 1.0 Universal (Public Domain)