# ConstructionOnline MCP by usefulapi

> ConstructionOnline MCP by usefulapi is a freemium MCP server. Read-only access to ConstructionOnline contacts, projects, opportunities and schedules. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/constructiononline/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/constructiononline
- **MCP Registry name:** io.usefulapi/constructiononline
- **Listing updated:** 2026-11-18

## About

The README and product page describe a hosted MCP endpoint that connects an AI client to a ConstructionOnline account. Once connected, the assistant can look up a contact by ID, email or phone, and open individual projects, opportunities and schedules by their known IDs. The server calls the ConstructionOnline API using the access your own account already has, so it only returns records that account can see.

Returned records are trimmed to selected operational fields. Notes, permissions, attachments and personal or payroll fields are excluded, according to the product page. All six data tools are marked read-only, so the assistant cannot change ConstructionOnline records through this server.

Setup happens through OAuth in the client: you enter a ConstructionOnline login email, password, company API key and a known accessible contact ID on the hosted login page. The page states that the company needs a Business or Enterprise plan with API access enabled. It suits construction staff who already work in ConstructionOnline and want quick lookups inside Claude, ChatGPT or a code editor.

## Features

- **Contact lookup:** Find a contact by its ID, email address or phone number.
- **Project review:** Read a project's status and address from its known ID.
- **Schedule details:** Check a schedule's dates and associated project by ID.
- **Opportunity lookup:** Retrieve selected fields for an individual opportunity by ID.
- **Read-only tools:** All six data tools are marked read-only and omit notes and attachments.
- **OAuth login:** Clients sign in through a hosted login page instead of storing keys in config.

## Good for

- Look up a client contact from an email address during a call
- Check a project's status and address before a team discussion
- Review a schedule's dates and linked project by ID
- Pull a known opportunity's fields before a sales meeting

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http constructiononline https://constructiononline.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://constructiononline.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "constructiononline": {
      "url": "https://constructiononline.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "constructiononline": {
      "type": "http",
      "url": "https://constructiononline.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "constructiononline": {
      "serverUrl": "https://constructiononline.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "constructiononline": {
      "type": "http",
      "url": "https://constructiononline.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `constructiononline_get_contact`: Read one contact using its known id.
- `constructiononline_get_contact_by_email`: Read one contact using its known email.
- `constructiononline_get_contact_by_phone`: Read one contact using its known phone.
- `constructiononline_get_project`: Read one project using its known id.
- `constructiononline_get_opportunity`: Read one opportunity using its known id.
- `constructiononline_get_schedule`: Read one schedule using its known id.
- `constructiononline_usage_status`: Report the caller's current usage and plan limit.
- `constructiononline_request_feature`: Send a request for a missing ConstructionOnline capability.
- `constructiononline_upgrade`: Get a paid Pro or Pro+ plan for ConstructionOnline.
- `constructiononline_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official ConstructionOnline product?

No. The product page says usefulapi is an independent service and is not affiliated with or endorsed by ConstructionOnline.

### Can the AI change my ConstructionOnline data?

No. The page says all 6 ConstructionOnline tools are marked read-only.

### What do I need to connect?

The login page asks for your ConstructionOnline login email, password, Company API key and a Known accessible contact ID. The company needs Business or Enterprise with API access enabled.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls. Each subscription covers this server only.

### Is ConstructionOnline MCP by usefulapi free?

ConstructionOnline MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add ConstructionOnline MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http constructiononline https://constructiononline.usefulapi.io/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/constructiononline-mcp-by-usefulapi
