Staffa Developer Ecosystem
Autonomous contractor clearinghouse connecting AI agents, IDE assistants, and Linux CLI scripts directly to 30,000+ verified UK emergency trade contractors.
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
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"]
}
}
}
pip install staffa-mcp
Node.js / npx (Zero Install)
npmNative Node 18+ stdio proxy using built-in fetch. Works seamlessly in Cursor and Claude Desktop.
{
"mcpServers": {
"staffa": {
"command": "npx",
"args": ["-y", "@staffa/mcp"]
}
}
}
npx -y @staffa/mcp lookup -p SW14
Direct REST & OpenAPI 3.1 Endpoints
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"}'
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
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.