ServiceFusion MCP Server

A Model Context Protocol (MCP) server that provides AI agents with standardized access to ServiceFusion API operations.

Features

OAuth 2.0 Authentication: Automatic token management and refresh
Complete CRUD Operations: Create, read, update, and delete customers and jobs
Type-Safe Interface: Full TypeScript support with validation
Resource Access: MCP resources for browsing customers and jobs
Error Handling: Comprehensive error handling and validation

Available Tools

Connection Management

sf_test_connection - Test ServiceFusion API connectivity
sf_get_api_status - Get current authentication status

Customer Operations

sf_create_customer - Create new customers with contacts and locations
sf_get_customers - Search and retrieve customers with pagination

Job Operations

sf_create_job - Create new work orders/jobs
sf_get_jobs - Search and retrieve jobs with filtering
sf_update_job - Update job status and details
sf_delete_job - Delete/cancel jobs

Available Resources

servicefusion://customers - Paginated list of customers
servicefusion://jobs - Paginated list of jobs
servicefusion://customer/{id} - Individual customer details
servicefusion://job/{id} - Individual job details
servicefusion://api-status - API connection status

Installation

Clone and install dependencies:

npm install

Set up environment variables:

cp .env.example .env
# Edit .env with your ServiceFusion credentials

Build the project:

npm run build

Usage

Running the MCP Server

npm start

Development Mode

npm run dev

Testing

npm test

Configuration

Set the following environment variables:

SERVICEFUSION_CLIENT_ID - Your ServiceFusion API client ID
SERVICEFUSION_CLIENT_SECRET - Your ServiceFusion API client secret
SERVICEFUSION_BASE_URL - (Optional) API base URL (defaults to https://api.servicefusion.com)

Integration with Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "servicefusion": {
      "command": "node",
      "args": ["/path/to/servicefusion-mcp/build/index.js"],
      "env": {
        "SERVICEFUSION_CLIENT_ID": "your_client_id",
        "SERVICEFUSION_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

API Examples

Create a Customer

await sf_create_customer({
  customer_name: "ABC Property Management",
  contacts: [{
    fname: "John",
    lname: "Doe", 
    contact_type: "Primary",
    phone: "555-1234",
    email: "john@abc.com"
  }],
  locations: [{
    street_1: "123 Main St",
    city: "Dallas",
    state_prov: "TX",
    postal_code: "75201"
  }]
});

Create a Job

await sf_create_job({
  check_number: "WO-12345",
  customer_id: 123456,
  description: "HVAC repair needed",
  category: "Maintenance",
  priority: "High",
  street_1: "123 Main St",
  city: "Dallas",
  state_prov: "TX"
});

Search Jobs

await sf_get_jobs({
  page: 1,
  customer_name: "ABC Property",
  status: "Scheduled",
  updated_since: "2025-01-01T00:00:00Z"
});

Data Models

Customer

customer_name (required)
parent_customer (optional) - For hierarchical customers
contacts[] - Array of contact information
locations[] - Array of location information

Job

check_number (required) - Unique identifier
customer_id (required) - Associated customer
description (required) - Job description
status - Job status (Scheduled, In Progress, Completed, etc.)
priority - Job priority (Normal, High, Low)
custom_fields[] - Custom field values

Error Handling

The server includes comprehensive error handling for:

Authentication failures (automatic token refresh)
API rate limits and timeouts
Invalid input validation
Network connectivity issues

Contributing

Make changes to TypeScript files in src/
Build with npm run build
Test with npm test
Submit pull requests with tests

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI agents to interact with ServiceFusion's field service management platform through standardized MCP operations. Supports complete customer and job management including creating work orders, managing customer records, and accessing service data with OAuth 2.0 authentication.

Related MCP Servers

Azure AI Agent Service MCP Server
azure-ai-foundry
-
security
A
license
-
quality
Enables connections to Azure AI Agents within any MCP client, allowing users to leverage Azure AI Foundry's models and knowledge tools like Azure AI Search and Bing Web Grounding through a conversational interface.
Last updated -
180
Python
MIT License
Agentforce MCP Server
xlengelle-sf
-
security
F
license
-
quality
This MCP server provides tools to interact with the Salesforce Agentforce API, allowing authentication, session creation, and message exchange with Salesforce agents.
Last updated -
10
Python
Secure Remote MCP Server
Azure-Samples
-
security
A
license
-
quality
Acts as an AI Gateway for MCP servers using Azure API Management, implementing the latest MCP Authorization specification.
Last updated -
91
MIT License
MCP AI Service Platform
dkb12138ggg
-
security
A
license
-
quality
A powerful AI service platform that provides complete MCP tool calling capabilities and RAG knowledge base functionality, enabling users to connect to multiple MCP servers and perform intelligent document search.
Last updated -
Python
Apache 2.0

View all related MCP servers

ServiceFusion MCP Server