Model Context Protocol (2024-11-05) & OpenAPI 3.1 Live

Staffa Developer Ecosystem

Autonomous contractor clearinghouse connecting AI agents, IDE assistants, and Linux CLI scripts directly to 30,000+ verified UK emergency trade contractors.

PyPI Package
staffa-mcp
npm Package
@staffa/mcp
Cursor IDE
Verified stdio
Smithery.ai
Catalog Ready
Glama.ai
Indexed Host

1-Command Linux / macOS CLI Installer

Installs the zero-dependency staffa-mcp binary into ~/.local/bin/staffa-mcp. Runs on any standard Python 3.9+ installation with zero pip dependencies.

curl -fsSL https://staffa.work/install.sh | bash
Once installed, run staffa-mcp lookup --postcode "SW14 8AN" --trade heating from any bash/zsh shell.

MCP Client Configurations (Cursor, Claude & VS Code)

Python / uvx (Zero Install)

PyPI

Ideal for systems with uv or Python environments. Zero dependencies, instant startup.

{
  "mcpServers": {
    "staffa": {
      "command": "uvx",
      "args": ["staffa-mcp"]
    }
  }
}
Or install via pip: pip install staffa-mcp

Node.js / npx (Zero Install)

npm

Native Node 18+ stdio proxy using built-in fetch. Works seamlessly in Cursor and Claude Desktop.

{
  "mcpServers": {
    "staffa": {
      "command": "npx",
      "args": ["-y", "@staffa/mcp"]
    }
  }
}
Direct query: npx -y @staffa/mcp lookup -p SW14

Direct REST & OpenAPI 3.1 Endpoints

POST https://api.staffa.work/api/agent/v1/public/lookup

Zero-token, rate-limited public discovery endpoint for AI agents. Returns matched contractor, fixed diagnostic fee, and SLA.

curl -X POST https://api.staffa.work/api/agent/v1/public/lookup \
  -H "Content-Type: application/json" \
  -d '{"postcode": "SW14 8AN", "trade_category": "heating"}'
GET https://api.staffa.work/api/openapi.json

Full OpenAPI 3.1.0 specification compatible with ChatGPT Actions, Claude Connectors, and LibreChat.

curl -s https://api.staffa.work/api/openapi.json | jq .paths
POST https://api.staffa.work/api/mcp/dispatch

Standard JSON-RPC 2.0 endpoint handling initialize, tools/list, and tools/call.

Architectural Guarantees

  • Zero Synthetic Data: 100% real UK entities sourced from live statutory registers across 737 SIC categories.
  • Transparent Diagnostic Pricing: All contractor profiles carry pre-agreed fixed diagnostic fees prior to dispatch.
  • Zero-Dependency Bridges: Both Python and Node packages use native platform standard libraries with zero external dependencies.