Developer & AI Integration Hub

Developer API & MCP Integration Guide

Build custom trade software, CRM integrations (Jobber, Hubspot), or connect AI assistants (Claude Desktop, Cursor, ChatGPT) directly to your Tradesman Quote Wizard engine.

🔑

Building Custom REST API Apps?

Generate REST API keys in your settings under the API Developer Pro Plan (£49/mo). MCP Server access for Claude & AI assistants uses 1-click OAuth 2.0 and is Included Free for all registered accounts.

Developer Portal →

1-Click OAuth 2.0 & Remote MCP Server Access

Tradesmen Quote Wizard provides an out-of-the-box Remote MCP Server for all registered accounts. Connect your AI assistant (Claude Desktop, Claude.ai, ChatGPT, or custom agents) instantly via standard 1-click OAuth 2.0 authorization or direct Server-Sent Events (SSE) transport with no API keys required.

🧡

Claude.ai & Claude Desktop

Active & Certified

Connect Tradesman Quote Wizard directly inside Claude Desktop or Claude.ai to inspect jobs, add line items, update prices, and generate quotes via natural language prompts.

📋 Step-by-Step Connection SOP:
Requires paid Claude plan (Pro/Team)
Step 1:Open ClaudeSettingsConnectorsAdd custom connector.
Step 2:In the Name box, type TradesMan Quote.
Step 3:In the Remote MCP server URL box, paste https://api.tradesmanquote.co.uk/mcp/sse.
Step 4:Click Add, then click Authorize to log in with your account credentials.
⚡ 1-Click Authorize Connector for Claude ↗
https://api.tradesmanquote.co.uk/mcp/sse
🤖

ChatGPT, Cursor & OpenAI Codex

Pending / Coming Soon

Direct integration for OpenAI Custom GPTs, Cursor, and Codex agents is currently under review and will be released in an upcoming update.

Status: Connector Pending Certification

For now, please use the official Claude.ai & Claude Desktop connector above for full interactive tool access.

https://api.tradesmanquote.co.uk/openapi.json

OAuth 2.0 Server Authorization Specs

For custom MCP clients or agent frameworks, configure your OAuth client using our standard discovery endpoint:

Authorization Endpoint : https://api.tradesmanquote.co.uk/oauth/authorize
Token Endpoint         : https://api.tradesmanquote.co.uk/oauth/token
Discovery Metadata     : https://api.tradesmanquote.co.uk/.well-known/oauth-authorization-server
Supported Grants       : authorization_code, refresh_token, PKCE (S256)

Example Prompts for Tradesmen & AI Agents

Create Job & Quote

"Create a new job for 14 High Street, client Dave Smith. Scope: 15m² of wall tiling in bathroom, London Inner rates. Run the Smart Scan and show me the draft quote."

Edit Quote & Generate Deliverables

"Change line 1 quantity to 18m², switch tiling price to High tier, and generate a companion merchant materials list."