Developer Documentation

Connect your AI agent or application to GuildHall's verification and matching pipeline via MCP, A2A, or REST API.

MCP Server

Primary AI agent interface. Connect any MCP-compatible AI agent to GuildHall's full pipeline.

// Claude Desktop config (~/.config/claude/claude_desktop_config.json)
{
  "mcpServers": {
    "guildhall": {
      "command": "npx",
      "args": ["@guildhall/mcp-server"],
      "env": {
        "SUPABASE_URL": "your-url",
        "SUPABASE_SERVICE_ROLE_KEY": "your-key",
        "OPENAI_API_KEY": "your-key"
      }
    }
  }
}

Available Tools

verify_credential

Verify TDLR license status or provider credentials

Params: license_number?, provider_id?, state?

lookup_requirement

What inspections/services are required for equipment in a jurisdiction

Params: trade, equipment_type, jurisdiction

explain_regulation

Plain-English explanation of a code section or regulation

Params: reference

check_compliance_status

Is equipment compliant? What's overdue?

Params: equipment_type, jurisdiction, last_service_date?

get_equipment_info

Specs, known issues, inspection notes for equipment

Params: query

find_qualified_provider

Find verified providers by trade, location, equipment expertise

Params: trade, location_state, location_city?, equipment_type?, limit?

check_availability

Check a provider's availability for a date range

Params: provider_id, date_range_start, date_range_end

initiate_match

Create a service request and start the matching pipeline

Params: trade, service_type, description, location_state, ...

search_knowledge

Semantic search across compliance intelligence knowledge base

Params: query, limit?

A2A Agent Card

GuildHall publishes an A2A Agent Card for agent-to-agent discovery.

GET https://joinguildhall.ai/.well-known/agent.json

REST API

Same endpoints as the MCP server, available as standard REST.

# Verify a credential (any TDLR trade)
GET /api/verify?license_number=123456

# Submit a service request
POST /api/request
Content-Type: application/x-www-form-urlencoded

trade=electrician&description=Need+panel+upgrade&location_state=TX&location_city=Houston

API Tiers

TierDaily LimitPrice
Free100 queries/day$0
Partner1,000 queries/day$50–$200/mo
PremiumUnlimited$500+/mo