BlueFolder MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server that lets an assistant read BlueFolder customers, service requests, equipment and contracts, and add jobs and comments.

What you can do
  • List and fetch customers with their contacts and locations
  • List and fetch service requests with items, labor, materials, assignments and billing totals, plus history and comments
  • List and fetch equipment, service contracts, catalog items, users and tax codes
  • Create service requests and add service request or customer comments
  • Check monthly usage, request a feature, upgrade or cancel the subscription
When to use it
Useful for field-service teams already on BlueFolder who want to ask questions in plain language about open jobs, customer equipment and service due dates, or have an assistant log new service requests and comments without opening the BlueFolder UI.
Requirements
Remote endpoint over streamable HTTP; no local install. Sign-in uses OAuth, and the login page asks for a BlueFolder API token (BlueFolder Settings, API; API access requires a BlueFolder Premium plan). The token is stored per user by the service; no key goes in the client config. Network access required.
Before you install
The BlueFolder API token is entered at the hosted login page and stored by the third party, so the provider can act on your BlueFolder account. Three tools write data: creating service requests and adding comments; a public comment with notifyCustomer true emails the customer, and creating a request can notify the customer if notifyCustomer is true. Usage is metered: free plan 50 calls a month, paid plans cost money via a Stripe checkout link, and cancellation gives no refund for the current…

Installation

In SourceWeft

  1. Open BlueFolder MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbluefolder/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

BlueFolder MCP by usefulapi

Use your BlueFolder account from Claude, Cursor, or any MCP client. Read customers, equipment, service requests and contracts, and add service requests and comments. Hosted, no local install: connect with your own credentials.

Live endpoint: https://bluefolder.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bluefolder.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "bluefolder": {      "url": "https://bluefolder.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your BlueFolder credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bluefolder/

On first connect you provide your BlueFolder API token (BlueFolder → Settings → API, in the Authorized API Users table; API access needs a Premium plan). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
bluefolder_list_customersreadList customers
bluefolder_get_customerreadGet a customer
bluefolder_list_service_requestsreadList service requests
bluefolder_get_service_requestreadGet a service request
bluefolder_get_service_request_historyreadGet service request history
bluefolder_list_equipmentreadList equipment
bluefolder_get_equipmentreadGet equipment
bluefolder_list_contractsreadList contracts
bluefolder_get_contractreadGet a contract
bluefolder_list_itemsreadList items
bluefolder_get_itemreadGet an item
bluefolder_list_usersreadList users
bluefolder_get_userreadGet a user
bluefolder_list_tax_codesreadList tax codes
bluefolder_add_service_requestwriteCreate a service request
bluefolder_add_service_request_commentwriteAdd a service request comment
bluefolder_add_customer_commentwriteAdd a customer comment
bluefolder_usage_statusmetaUsage status (free-tier meter)
bluefolder_request_featuremetaRequest a missing feature
bluefolder_upgrademetaUpgrade to Pro or Pro+
bluefolder_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with bluefolder_upgrade (it returns a Stripe Checkout link). Cancel any time with bluefolder_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bluefolder_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/bluefolder/README.md at commit 4046075

Tools

17

bluefolder_list_customers

List customers

List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.

ParameterslistType

bluefolder_get_customer

Get a customer

Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.

ParameterscustomerIdexternalId

bluefolder_list_service_requests

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.

ParametersstatusendDatelistTypedateFieldinvoiceNostartDatecustomerIdreferenceNocustomerNamebillingStatuscustomerNameExactMatch

bluefolder_get_service_request

Get a 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.

ParametersexternalIdgroupItemsByTypeserviceRequestId

bluefolder_get_service_request_history

Get service request history

Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.

ParametersexternalIdserviceRequestId

bluefolder_list_equipment

List equipment

List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.

ParameterslistTypecustomerIdcustomerExternalId

bluefolder_get_equipment

Get equipment

Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.

ParametersequipmentIdrequired

bluefolder_list_contracts

List contracts

List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.

ParametersstatuslistTypecustomerIdcustomerName

bluefolder_get_contract

Get a contract

Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.

ParameterscontractIdrequired

bluefolder_list_items

List items

List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.

ParameterslistType

bluefolder_get_item

Get an item

Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.

ParametersitemIdrequired

bluefolder_list_users

List users

List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.

ParameterslistType

bluefolder_get_user

Get a user

Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.

ParametersuserIdrequired

bluefolder_list_tax_codes

List tax codes

List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.

Takes no parameters.

bluefolder_add_service_request

Create a 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.

ParametersdueDatebillableprioritycustomerIdrequiredexternalIddescriptionrequiredreferenceNonotifyCustomerpurchaseOrderNocustomerContactIdcustomerLocationIddetailedDescription

bluefolder_add_service_request_comment

Add a 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.

ParametersuserIdcommentrequirednotifyCustomercommentIsPublicserviceRequestIdrequired

bluefolder_add_customer_comment

Add a customer comment

Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.

ParametersuserIdcommentrequiredcustomerIdrequired

Version history

7
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026