# Acculynx — how to use (mcp.ai)

Connect your Acculynx account and use 8 tools for CRM straight from your AI agent. Connect with your own API key. AccuLynx is the leading, all-in-one roofing software designed to streamline every aspect of a roofing business.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_acculynx?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `acculynx_add_job_appointment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/acculynx`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/acculynx/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/acculynx/add/job/appointment` — This endpoint allows users to schedule the initial appointment for a specific job in the AccuLynx system. It is used to set up the first meeting or site visit for a construction or roofing project. Th
  - body: { jobId: string, endDate: string, startDate: string }
- `POST https://api.mcp.ai/api/acculynx/create/a/contact` — Creates a new contact in the AccuLynx system with detailed information for use in roofing and construction project management. This endpoint allows for the addition of comprehensive contact details in
  - body: { note?: string, lastName?: string, firstName?: string, companyName?: string, phoneNumbers?: object[], contactTypeIds: string[], crossReference?: string, emailAddresses?: object[], companyJobTitle?: string, billingAddress__city?: string, mailingAddress__city?: string, billingAddress__street1?: string, billingAddress__street2?: string, billingAddress__zipCode?: string, mailingAddress__street1?: string, mailingAddress__street2?: string, mailingAddress__zipCode?: string, billingAddress__state__id?: integer, mailingAddress__state__id?: integer, billingAddress__country__id?: integer, mailingAddress__country__id?: integer, billingAddressSameAsMailingAddress?: boolean }
- `POST https://api.mcp.ai/api/acculynx/create/a/job` — Creates a new job in the AccuLynx system with the provided details. This endpoint allows you to initialize a job with essential information such as the associated contact, location, job category, work
  - body: { notes?: string, priority?: string, tradeTypes?: object[], contact__id?: string, workType__id?: integer, leadSource__id?: string, jobCategory__id?: integer, locationAddress__city?: string, locationAddress__state?: string, locationAddress__country?: string, locationAddress__street1?: string, locationAddress__street2?: string, locationAddress__zipCode?: string }
- `POST https://api.mcp.ai/api/acculynx/create/a/lead` — This endpoint creates a new lead in the AccuLynx system, specifically for residential roofing projects. It should be used when a new potential customer expresses interest in roofing services or when i
  - body: { lastName?: string, firstName: string, emailAddress: string }
- `POST https://api.mcp.ai/api/acculynx/job/appointment/summary` — Retrieves a list of appointments from the calendar associated with a specific job in AccuLynx. This endpoint is used to fetch scheduled events, such as site visits, inspections, or project milestones,
  - body: { jobId: string, endDate?: string, startDate?: string, pageStartIndex?: integer }
- `POST https://api.mcp.ai/api/acculynx/list/of/calendars/for/the/location` — Retrieves a list of calendars associated with the authenticated user or organization in AccuLynx. This endpoint provides access to the calendar data, which is crucial for scheduling and organizing tas
  - body: { pageSize?: integer, pageStartIndex?: integer }
- `POST https://api.mcp.ai/api/acculynx/list/of/contact/types/related/to/the/company` — Retrieves a list of all available contact types in the AccuLynx system. This endpoint is used to fetch the predefined categories or classifications for contacts, such as residential, repair, property 
  - body: { pageSize?: integer, pageStartIndex?: integer }
- `POST https://api.mcp.ai/api/acculynx/update/company/representative` — This endpoint allows you to add a company representative to a specific job within the AccuLynx system. It is used when you need to associate a representative with a particular project or task. The end
  - body: { id?: string, jobId: string }

## Example prompts
- "What can I do in Acculynx?"
- "Show me a summary of my Acculynx account"

## More
- Page: https://mcp.ai/acculynx
- Agent spec (llms.txt): https://mcp.ai/acculynx/llms.txt
- Postman collection: https://mcp.ai/acculynx/postman.json