Skip to content
MCP server

BlueFolder MCP by usefulapi

Read customers, equipment and service requests; add service requests and comments in…

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About BlueFolder MCP by usefulapi

BlueFolder MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read customers, equipment and service requests; add service requests and comments in BlueFolder.

Install

Run in a terminal

claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://bluefolder.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bluefolder": {
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bluefolder": {
      "type": "http",
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bluefolder": {
      "serverUrl": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bluefolder": {
      "type": "http",
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (17)

Read directly from the server.

bluefolder_list_customers
List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.
bluefolder_get_customer
Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.
bluefolder_list_service_requests
List service requests (jobs), optionally filtered by customer, status, billing status, invoice or reference number, or a created/closed date range. Use status 'open' for all non-closed requests. BlueFolder API: POST /serviceRequests/list.aspx.
bluefolder_get_service_request
Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.
bluefolder_get_service_request_history
Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.
bluefolder_list_equipment
List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.
bluefolder_get_equipment
Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.
bluefolder_list_contracts
List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.
bluefolder_get_contract
Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.
bluefolder_list_items
List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.
bluefolder_get_item
Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.
bluefolder_list_users
List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.
bluefolder_get_user
Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.
bluefolder_list_tax_codes
List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.
bluefolder_add_service_request
Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.
bluefolder_add_service_request_comment
Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.
bluefolder_add_customer_comment
Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.

BlueFolder MCP by usefulapi FAQ

How do I add BlueFolder MCP by usefulapi to Claude Code?

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