BlueFolder MCP by usefulapi is an MCP server published by io.usefulapi, hosted at bluefolder.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 17 tools, including bluefolder_list_customers, bluefolder_get_customer, bluefolder_list_service_requests, bluefolder_get_service_request, bluefolder_get_service_request_history.
Read customers, equipment and service requests; add service requests and comments in BlueFolder.
3,997 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.
| Parameter | Type | Description |
|---|---|---|
| listType | string | 'basic' (default) or 'full' (more fields). |
{
"name": "bluefolder_list_customers",
"title": "List customers",
"description": "List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| customerId | string | Numeric BlueFolder id. |
| externalId | string | Your external identifier for the customer. |
{
"name": "bluefolder_get_customer",
"title": "Get a customer",
"description": "Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
},
"externalId": {
"type": "string",
"description": "Your external identifier for the customer."
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| status | string | Status to filter by, or 'open'. |
| endDate | string | Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges). |
| listType | string | 'basic' (default) or 'full' (more fields). |
| dateField | string | Date field for the range. |
| invoiceNo | string | Invoice number to find. |
| startDate | string | Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges). |
| customerId | string | Numeric BlueFolder id. |
| referenceNo | string | Reference number to find. |
| customerName | string | Filter by customer name. |
| billingStatus | string | Billing status to filter by. |
Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| externalId | string | Your external identifier for the service request. |
| groupItemsByType | boolean | Group items by item type (vendor default: true). |
| serviceRequestId | string | Numeric BlueFolder id. |
{
"name": "bluefolder_get_service_request",
"title": "Get a service request",
"description": "Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"externalId": {
"type": "string",
"description": "Your external identifier for the service request."
},
"groupItemsByType": {
"type": "boolean",
"description": "Group items by item type (vendor default: true)."
},
"serviceRequestId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Get a service request",
"readOnlyHint": true
}
}Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.
| Parameter | Type | Description |
|---|---|---|
| externalId | string | Your external identifier for the service request. |
| serviceRequestId | string | Numeric BlueFolder id. |
{
"name": "bluefolder_get_service_request_history",
"title": "Get service request history",
"description": "Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"externalId": {
"type": "string",
"description": "Your external identifier for the service request."
},
"serviceRequestId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Get service request history",
"readOnlyHint": true
}
}List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.
| Parameter | Type | Description |
|---|---|---|
| listType | string | 'basic' (default) or 'full' (more fields). |
| customerId | string | Numeric BlueFolder id. |
| customerExternalId | string | Your external identifier for the customer. |
{
"name": "bluefolder_list_equipment",
"title": "List equipment",
"description": "List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
},
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
},
"customerExternalId": {
"type": "string",
"description": "Your external identifier for the customer."
}
}
},
"annotations": {
"title": "List equipment",
"readOnlyHint": true
}
}Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| equipmentId * | string | Equipment GUID (from bluefolder_list_equipment). |
{
"name": "bluefolder_get_equipment",
"title": "Get equipment",
"description": "Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"equipmentId"
],
"properties": {
"equipmentId": {
"type": "string",
"minLength": 1,
"description": "Equipment GUID (from bluefolder_list_equipment)."
}
}
},
"annotations": {
"title": "Get equipment",
"readOnlyHint": true
}
}List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.
| Parameter | Type | Description |
|---|---|---|
| status | string | Status to filter by. |
| listType | string | 'basic' (default) or 'full' (more fields). |
| customerId | string | Numeric BlueFolder id. |
| customerName | string | Filter by customer name. |
{
"name": "bluefolder_list_contracts",
"title": "List contracts",
"description": "List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"type": "string",
"description": "Status to filter by."
},
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
},
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
},
"customerName": {
"type": "string",
"description": "Filter by customer name."
}
}
},
"annotations": {
"title": "List contracts",
"readOnlyHint": true
}
}Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| contractId * | string | Numeric BlueFolder id. |
{
"name": "bluefolder_get_contract",
"title": "Get a contract",
"description": "Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contractId"
],
"properties": {
"contractId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Get a contract",
"readOnlyHint": true
}
}List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.
| Parameter | Type | Description |
|---|---|---|
| listType | string | 'basic' (default) or 'full' (more fields). |
{
"name": "bluefolder_list_items",
"title": "List items",
"description": "List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
}
}
},
"annotations": {
"title": "List items",
"readOnlyHint": true
}
}Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| itemId * | string | Numeric BlueFolder id. |
{
"name": "bluefolder_get_item",
"title": "Get an item",
"description": "Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"itemId"
],
"properties": {
"itemId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Get an item",
"readOnlyHint": true
}
}List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.
| Parameter | Type | Description |
|---|---|---|
| listType | string | 'basic' (default) or 'full' (more fields). |
{
"name": "bluefolder_list_users",
"title": "List users",
"description": "List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.
| Parameter | Type | Description |
|---|---|---|
| userId * | string | Numeric BlueFolder id. |
{
"name": "bluefolder_get_user",
"title": "Get a user",
"description": "Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Get a user",
"readOnlyHint": true
}
}List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.
No parameters.
{
"name": "bluefolder_list_tax_codes",
"title": "List tax codes",
"description": "List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List tax codes",
"readOnlyHint": true
}
}Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.
| Parameter | Type | Description |
|---|---|---|
| dueDate | string | Due date, as the vendor accepts it. |
| billable | boolean | |
| priority | string | Priority value from your account. |
| customerId * | string | Numeric BlueFolder id. |
| externalId | string | Your external identifier for the new request. |
| description * | string | Short description (the job title). |
| referenceNo | string | |
| notifyCustomer | boolean | true = email the customer. Default: false. |
| purchaseOrderNo | string | |
| customerContactId | string | Contact at the customer. Default: the primary contact. |
| customerLocationId |
Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.
| Parameter | Type | Description |
|---|---|---|
| userId | string | The user the comment is attributed to. |
| comment * | string | The comment text. |
| notifyCustomer | boolean | true = email the customer about the comment. |
| commentIsPublic | boolean | true = visible to the customer. |
| serviceRequestId * | string | Numeric BlueFolder id. |
{
"name": "bluefolder_add_service_request_comment",
"title": "Add a service request comment",
"description": "Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"serviceRequestId",
"comment"
],
"properties": {
"userId": {
"type": "string",
"pattern": "^\\d+$",
"description": "The user the comment is attributed to."
},
"comment": {
"type": "string",
"description": "The comment text."
},
"notifyCustomer": {
"type": "boolean",
"description": "true = email the customer about the comment."
},
"commentIsPublic": {
"type": "boolean",
"description": "true = visible to the customer."
},
"serviceRequestId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Add a service request comment",
"destructiveHint": true
}
}Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.
| Parameter | Type | Description |
|---|---|---|
| userId | string | The user the comment is attributed to. |
| comment * | string | The comment text. |
| customerId * | string | Numeric BlueFolder id. |
{
"name": "bluefolder_add_customer_comment",
"title": "Add a customer comment",
"description": "Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customerId",
"comment"
],
"properties": {
"userId": {
"type": "string",
"pattern": "^\\d+$",
"description": "The user the comment is attributed to."
},
"comment": {
"type": "string",
"description": "The comment text."
},
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
}
}
},
"annotations": {
"title": "Add a customer comment",
"destructiveHint": true
}
}Tools for BlueFolder, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which service requests are still open for our biggest customer?"; "Show the equipment at this customer and when each unit is due for service."; "Create a service request for a broken chiller at the Acme site, without emailing the customer.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes BlueFolder data. Free plan: 50 tool calls per month. Run bluefolder_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run bluefolder_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run bluefolder_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bluefolder_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| customerNameExactMatch | boolean | true = the name must match exactly. |
{
"name": "bluefolder_list_service_requests",
"title": "List service requests",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"type": "string",
"description": "Status to filter by, or 'open'."
},
"endDate": {
"type": "string",
"description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges)."
},
"listType": {
"enum": [
"basic",
"full"
],
"type": "string",
"description": "'basic' (default) or 'full' (more fields)."
},
"dateField": {
"enum": [
"dateTimeCreated",
"dateTimeClosed"
],
"type": "string",
"description": "Date field for the range."
},
"invoiceNo": {
"type": "string",
"description": "Invoice number to find."
},
"startDate": {
"type": "string",
"description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges)."
},
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
},
"referenceNo": {
"type": "string",
"description": "Reference number to find."
},
"customerName": {
"type": "string",
"description": "Filter by customer name."
},
"billingStatus": {
"type": "string",
"description": "Billing status to filter by."
},
"customerNameExactMatch": {
"type": "boolean",
"description": "true = the name must match exactly."
}
}
},
"annotations": {
"title": "List service requests",
"readOnlyHint": true
}
}| string |
| Location at the customer. Default: the primary location. |
| detailedDescription | string | Full job description. |
{
"name": "bluefolder_add_service_request",
"title": "Create a service request",
"description": "Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customerId",
"description"
],
"properties": {
"dueDate": {
"type": "string",
"description": "Due date, as the vendor accepts it."
},
"billable": {
"type": "boolean"
},
"priority": {
"type": "string",
"description": "Priority value from your account."
},
"customerId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric BlueFolder id."
},
"externalId": {
"type": "string",
"description": "Your external identifier for the new request."
},
"description": {
"type": "string",
"description": "Short description (the job title)."
},
"referenceNo": {
"type": "string"
},
"notifyCustomer": {
"type": "boolean",
"description": "true = email the customer. Default: false."
},
"purchaseOrderNo": {
"type": "string"
},
"customerContactId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Contact at the customer. Default: the primary contact."
},
"customerLocationId": {
"type": "string",
"pattern": "^\\d+$",
"description": "Location at the customer. Default: the primary location."
},
"detailedDescription": {
"type": "string",
"description": "Full job description."
}
}
},
"annotations": {
"title": "Create a service request",
"destructiveHint": true
}
}