SolarPlus MCP by usefulapi
Read contacts and contact fields, and create or update contacts in SolarPlus.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- LOWsolarplus_update_contact에서
- LOWsolarplus_list_custom_contact_fields에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"solarplus": {
"url": "https://solarplus.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://solarplus.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (5)
🟢solarplus_get_contact(contact_id)
Get one contact by id: name, email, phone, full address, status, source, business name, categories and notes. SolarPlus API: GET /api/contact/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "The contact id (from solarplus_create_contact or the SolarPlus app)."
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢solarplus_list_contact_fields
List the built-in contact fields with name, label, type, required flag and select options. Use it before creating or updating contacts. SolarPlus API: GET /api/contact/fields.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢solarplus_list_custom_contact_fields
List the custom contact fields this company set up, with the name to use in custom_fields. SolarPlus API: GET /api/contact/custom-fields.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴solarplus_create_contact(first_name, last_name, email, full_address, primary_phone, ...)
Create a contact (a lead by default). Required: first name, last name, email and full address. Creates a new record in the SolarPlus CRM. SolarPlus API: POST /api/contact.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "First name of the contact."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Last name of the contact."
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 254,
"description": "Email address of the contact."
},
"full_address": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Full address of the contact and site, for example '222 Exhibition St, Melbourne VIC 3000, Australia'."
},
"primary_phone": {
"description": "Primary phone number.",
"type": "string",
"maxLength": 60
},
"business_name": {
"description": "Business name of the contact.",
"type": "string",
"maxLength": 200
},
"notes": {
"description": "Notes for this contact.",
"type": "string",
"maxLength": 5000
},
"business_as_client": {
"description": "true = quotes show the business name as the client name.",
"type": "boolean"
},
"source": {
"description": "Lead source: 0 Other, 1 TV, 2 Radio, 3 Press, 4 Google, 5 Tradeshow, 6 Friends, 7 Website, 8 Word of Mouth, 9 Solar Quotes.",
"type": "integer",
"minimum": 0,
"maximum": 9
},
"status": {
"description": "Status: 0 Lead, 1 Active, 2 Closed.",
"type": "integer",
"minimum": 0,
"maximum": 2
},
"customer_rep": {
"description": "Name of the customer representative.",
"type": "string",
"maxLength": 200
},
"categories": {
"description": "Business categories as { category_name: value }.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
},
"custom_fields": {
"description": "Custom fields as { field_name: value }. List the names with solarplus_list_custom_contact_fields.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
}
},
"required": [
"first_name",
"last_name",
"email",
"full_address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴solarplus_update_contact(contact_id, first_name, last_name, email, full_address, ...)
Change the given fields of one contact. Fields you leave out keep their current value. SolarPlus API: POST /api/contact/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "The contact id (from solarplus_create_contact or the SolarPlus app)."
},
"first_name": {
"description": "First name of the contact.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"last_name": {
"description": "Last name of the contact.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Email address of the contact.",
"type": "string",
"minLength": 1,
"maxLength": 254
},
"full_address": {
"description": "Full address of the contact and site.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"primary_phone": {
"description": "Primary phone number.",
"type": "string",
"maxLength": 60
},
"business_name": {
"description": "Business name of the contact.",
"type": "string",
"maxLength": 200
},
"notes": {
"description": "Notes for this contact.",
"type": "string",
"maxLength": 5000
},
"business_as_client": {
"description": "true = quotes show the business name as the client name.",
"type": "boolean"
},
"source": {
"description": "Lead source: 0 Other, 1 TV, 2 Radio, 3 Press, 4 Google, 5 Tradeshow, 6 Friends, 7 Website, 8 Word of Mouth, 9 Solar Quotes.",
"type": "integer",
"minimum": 0,
"maximum": 9
},
"status": {
"description": "Status: 0 Lead, 1 Active, 2 Closed.",
"type": "integer",
"minimum": 0,
"maximum": 2
},
"customer_rep": {
"description": "Name of the customer representative.",
"type": "string",
"maxLength": 200
},
"categories": {
"description": "Business categories as { category_name: value }.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
},
"custom_fields": {
"description": "Custom fields as { field_name: value }. List the names with solarplus_list_custom_contact_fields.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거