SingleOps MCP by usefulapi
Search clients, list operations and custom inputs; create leads in SingleOps.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"singleops": {
"url": "https://singleops.usefulapi.io/mcp"
}
}
}Remote endpoints
https://singleops.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢singleops_list_operations
List the operations (divisions) of the SingleOps account. A lead needs an operation `id` from this list. Read-only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢singleops_list_custom_inputs
List the custom input fields of the account (for example a 'Lead Source' field). Use the `id` as `custom_input_id` when you create a lead. Read-only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢singleops_search_clients(search_field, search_term, page)
Search existing clients by email or phone (prefix match, up to 50 results per page). Search first, then pass the client `id` to singleops_create_lead to avoid a duplicate client. Read-only.
Input Schema
{
"type": "object",
"properties": {
"search_field": {
"type": "string",
"enum": [
"email",
"phone"
],
"description": "Field to search."
},
"search_term": {
"type": "string",
"minLength": 1,
"description": "Email address or phone number (prefix match)."
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"search_field",
"search_term"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴singleops_create_lead(operation_id, client_id, name, job_notes, client_notes, ...)
WRITE: create a new lead in SingleOps (stage Lead). Not idempotent: each call creates a new lead, so do not repeat it. Needs `operation_id` (singleops_list_operations) and either `client_id` (singleops_search_clients) or client details in `portal_lead`. A person must confirm the lead in SingleOps before it counts as valid. Optionally creates a task with it.
Input Schema
{
"type": "object",
"properties": {
"operation_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Operation (division) id."
},
"client_id": {
"description": "Existing client id. Leave out for a new client.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"name": {
"description": "Lead name (max 41 characters).",
"type": "string",
"maxLength": 41
},
"job_notes": {
"description": "Internal notes.",
"type": "string"
},
"client_notes": {
"description": "Notes the client can see.",
"type": "string"
},
"crew_notes": {
"description": "Notes shown on the work order.",
"type": "string"
},
"sales_rep_ids": {
"description": "User ids that own the lead.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"tag_ids": {
"description": "Tag ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"custom_input_values": {
"description": "Custom input values.",
"type": "array",
"items": {
"type": "object",
"properties": {
"custom_input_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"value": {
"type": "string"
}
},
"required": [
"custom_input_id",
"value"
]
}
},
"portal_lead": {
"description": "Client contact and site address details.",
"type": "object",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"company_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"mobile": {
"type": "string"
},
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"us_state": {
"type": "string"
},
"zip": {
"type": "string"
},
"bill_addr_1": {
"type": "string"
},
"bill_addr_2": {
"type": "string"
},
"bill_addr_city": {
"type": "string"
},
"bill_addr_state": {
"type": "string"
},
"bill_addr_postal_code": {
"type": "string"
}
}
},
"task": {
"description": "Create a task together with the lead.",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"on_site": {
"type": "boolean"
},
"start": {
"description": "yyyy-mm-dd hh:mm:ss",
"type": "string"
},
"stop": {
"description": "yyyy-mm-dd hh:mm:ss",
"type": "string"
},
"all_day": {
"type": "boolean"
}
},
"required": [
"name"
]
}
},
"required": [
"operation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence