Documentation

WORKWAY Construction MCP provides 41 tools across 7 categories, plus 3 AI-powered Skills for construction automation. Connect your AI agent to Procore in minutes.

41 MCP Tools
7 Categories
3 AI Skills

Quick Start

1. Configure Your MCP Client

Add the WORKWAY Construction MCP server to your Claude Desktop or Codex configuration:

{
  "mcpServers": {
    "workway-construction": {
      "url": "https://workway-construction-mcp.half-dozen.workers.dev/mcp",
      "transport": "sse"
    }
  }
}

2. Connect to Procore

Use the workway_connect_procore tool to authenticate. You can connect to either production or sandbox:

// Connect to Procore production
"Connect to Procore so I can access project data"

// Or connect to sandbox for testing
"Connect to Procore sandbox environment"

The AI will return an authorization URL. Click it to complete OAuth authentication. Your tokens are securely stored and automatically refreshed.

3. Use AI Skills

Once connected, use natural language to invoke AI-powered Skills:

// Draft an RFI with AI
"Draft an RFI about the waterproofing membrane overlap not matching specs"

// Get executive summary of daily logs
"Summarize this week's daily logs for the Downtown Tower project"

// Review submittals for compliance issues
"Review pending submittals and flag any compliance concerns"

Intelligence Layer (AI Skills)

Skills use Cloudflare Workers AI to produce outcomes, not just data. Each skill generates a draft that requires human review before action.

workway_skill_draft_rfi AI Task: generate

Generates professional RFIs from your intent. Includes subject, question body, impact statement, and spec references.

Inputs: question_intent, spec_section, drawing_reference, priority, context
workway_skill_daily_log_summary AI Task: summarize

Transforms daily logs into executive summaries. Includes key metrics, notable events, weather impact, and recommendations.

Inputs: project_id, date_range, format (executive/detailed), include_recommendations
workway_skill_submittal_review AI Task: classify

Reviews submittals and flags compliance issues. Pattern analysis identifies bottlenecks and delays.

Inputs: project_id, focus (all/pending/overdue), spec_sections

Tool Categories

41 MCP tools organized into 7 categories:

Category Tools Description
procore 11 Connect, list companies/projects, get RFIs, daily logs, submittals, photos, documents, schedule, create RFIs
workflow 7 Create, configure triggers, add actions, deploy, test, list, rollback workflows
notifications 6 Send email/Slack, notify, configure notifications, alert errors
seeder 4 Seed test data: RFIs, daily logs, sample data for sandbox testing
skills 3 AI-powered: draft_rfi, daily_log_summary, submittal_review
templates 3 List, create from, and get workflow templates
debugging 3 Diagnose, get unstuck, observe execution

Environment Support

WORKWAY supports both Procore production and sandbox environments. Each user can connect to either environment independently.

Production vs Sandbox

  • Production — Real Procore data. Use for live projects.
  • Sandbox — Test environment. Use seeder tools to create sample data.

Switching Environments

To connect to a different environment, use the environment parameter:

// Production (default)
workway_connect_procore(environment: "production")

// Sandbox
workway_connect_procore(environment: "sandbox")

API Endpoints

GET https://workway-construction-mcp.half-dozen.workers.dev/mcp

Server info and capabilities

GET https://workway-construction-mcp.half-dozen.workers.dev/mcp/tools

List all 41 available tools with categories

POST https://workway-construction-mcp.half-dozen.workers.dev/mcp/tools/{tool_name}

Execute a tool

GET https://workway-construction-mcp.half-dozen.workers.dev/mcp/resources

List available resources

Authentication

WORKWAY uses OAuth 2.0 for Procore authentication. When you call workway_connect_procore, you'll receive an authorization URL. After completing the OAuth flow, your tokens are securely stored and automatically refreshed.

Security Features

  • Token Encryption — All tokens encrypted with AES-256-GCM
  • User Isolation — Each user's tokens stored separately
  • Automatic Refresh — Tokens refreshed before expiration
  • Secure Storage — Cloudflare D1 with encryption at rest
  • Environment Separation — Separate credentials for sandbox and production

Workflow Templates

Pre-built templates for common construction automations:

  • rfi_overdue_alert — Daily notifications for overdue RFIs
  • weekly_project_summary — Monday morning project digest
  • submittal_status_digest — Daily submittal status report
  • daily_log_reminder — Afternoon reminder to submit daily logs
  • new_rfi_notification — Instant alerts when RFIs are created
  • submittal_approved_notification — Alerts when submittals are approved

Rate Limits

The MCP server respects Procore's rate limits:

  • 3,600 requests per minute
  • 100,000 requests per day

Support

Questions? Issues?