Back to Browse

Marketsharp MCP Server

Developer ToolsModerate5.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for MarketSharp CRM contacts, inquiries, appointments, jobs, notes and activities.

About

MCP server for MarketSharp CRM contacts, inquiries, appointments, jobs, notes and activities.

Security Report

5.6
Moderate5.6Moderate Risk

The MarketSharp MCP server is a read-only CRM connector with an explicit allowlist of GET and POST routes, fixed API host with redirects refused, strict id validation, redaction of credentials from outputs, and gateway-based S2S authentication for HTTP mode. Permissions (network_http, env_vars for credentials) match its stated purpose, and no exfiltration or malicious patterns were observed in the reviewed files; the truncated http.ts and remaining source files were not fully reviewed, so the score reflects only the visible code. Supply chain analysis found 4 known vulnerabilities in dependencies (2 critical, 0 high severity).

5 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

MarketSharp Company ID (shown under your username in MarketSharp).Optional

Environment variable: MARKETSHARP_COMPANY_ID

API key from MarketSharp: Admin → Apps & Add-ons Setup → API maintenance → Create New API Key.Required

Environment variable: MARKETSHARP_API_KEY

API secret issued with the API key. If there's no secret, ask MarketSharp support to turn on API access.Required

Environment variable: MARKETSHARP_API_SECRET

Optional MarketSharp employee ID. The contact, inquiry and job search tools and marketsharp_notes_list need it, and act with that employee's permissions.Optional

Environment variable: MARKETSHARP_EMPLOYEE_ID

Transport mode. Registry installs run the image over stdio, so this is 'stdio'. The image itself defaults to 'http' for gateway hosting.Optional

Environment variable: MCP_TRANSPORT

Credential source. Registry installs read the MARKETSHARP_* variables above, so this is 'env'. The image itself defaults to 'gateway', where credentials come only from x-marketsharp-* headers sent by the WYRE AI gateway and MARKETSHARP_* env is never read.Optional

Environment variable: AUTH_MODE

Log verbosity: debug, info, warn, errorOptional

Environment variable: LOG_LEVEL

How to Install

Install command not verified. See the repository for install instructions.

View repository

Documentation

View on GitHub

From the project's GitHub README.

marketsharp-mcp

MCP server for the MarketSharp CRM REST API (https://restapi.marketsharpm.com, API version 2.0). It gives an AI assistant read access to a home-improvement contractor's contacts, inquiries (leads), appointments, jobs, notes and reference lists. Every tool is read-only.

Maintained by WYRE AI. It runs as a stdio server locally or as a stateless Streamable HTTP server behind a gateway.

Credentials

MarketSharp uses application authentication: the server exchanges your Company ID, API key and API secret at POST /token for a short-lived bearer token, caches it per credential set, and refreshes it on expiry or a 401.

VariableGateway headerRequiredWhere to find it
MARKETSHARP_COMPANY_IDx-marketsharp-company-idyesShown under your username, top right in MarketSharp
MARKETSHARP_API_KEYx-marketsharp-api-keyyesAdmin → Apps & Add-ons Setup → API maintenance → Create New API Key
MARKETSHARP_API_SECRETx-marketsharp-api-secretyesIssued with the API key. If there's no secret, MarketSharp support has to turn on API access
MARKETSHARP_EMPLOYEE_IDx-marketsharp-employee-idnoMarketSharp employee ID. The contact, inquiry and job search tools, and marketsharp_notes_list need it, and act with that employee's permissions

Use a dedicated MarketSharp employee set up for API access rather than a person's login. The server never uses MarketSharp usernames or passwords.

Tools (25, all read-only)

ToolMarketSharp endpoint
marketsharp_companies_listGET /companies
marketsharp_companies_getGET /companies/{companyId}
marketsharp_search_globalPOST …/search/global (contacts, inquiries, jobs)
marketsharp_contacts_getGET …/contacts/{contactId}
marketsharp_contacts_searchPOST …/contacts/search (QuickFind, needs employee)
marketsharp_contacts_listPOST …/contacts/filter (paged, modified-since / appointment window)
marketsharp_inquiries_getGET …/inquiries/{inquiryId} (optional isAppointmentRequired; MarketSharp defaults it to true)
marketsharp_inquiries_listPOST …/inquiries/filter (paged; optional isAppointmentRequired, which MarketSharp defaults to true)
marketsharp_inquiries_searchPOST …/inquiries/search (QuickFind, needs employee)
marketsharp_inquiries_list_by_contactGET …/contacts/{contactId}/inquiries (optional isAppointmentRequired)
marketsharp_inquiry_statuses_listGET …/inquiries/statuses
marketsharp_inquiry_notes_listGET …/opportunities/{inquiryId}/notes/{Inquiry|Job} (needs View Opportunity Note)
marketsharp_appointments_getGET …/appointments/{appointmentId}
marketsharp_appointments_listPOST …/appointments/filter (paged)
marketsharp_appointments_list_by_contactGET …/appointments/contacts/{contactId}
marketsharp_appointment_results_listGET …/appointments/results/active or resultreasons/active
marketsharp_jobs_getGET …/jobs/{jobId}
marketsharp_jobs_searchPOST …/jobs/search (QuickFind, needs employee)
marketsharp_opportunities_listPOST …/jobs/opportunities (jobs + leads since a date, contract totals; needs View Opportunity)
marketsharp_notes_listGET …/notes/contact/{contactId} or by note type (needs employee)
marketsharp_activity_types_listGET …/activities/types
marketsharp_employees_listGET …/employees (paged)
marketsharp_lead_sources_listGET …/primaryleadsources[/…/secondaryleadsources]
marketsharp_product_interests_listGET …/products/interests/{activeOnly} or per inquiry (needs View Product Interest)
marketsharp_divisions_listGET …/divisions

There are no create, update or delete tools. Searches and filtered lists use POST because that is how MarketSharp exposes them; they don't change data. The client only sends the GET and POST routes these tools use (an allowlist of route templates in src/client.ts). Any other request, including a GET no tool uses, is refused before sign-in.

Running

Requires Node.js 22 or later.

npm ci && npm run build
MARKETSHARP_COMPANY_ID=… MARKETSHARP_API_KEY=… MARKETSHARP_API_SECRET=… node dist/index.js   # stdio

The Docker image defaults to MCP_TRANSPORT=http and AUTH_MODE=gateway. To run the image over stdio with MARKETSHARP_* credentials, pass -e MCP_TRANSPORT=stdio -e AUTH_MODE=env as well; otherwise it fails closed with "credentials are not configured".

HTTP (MCP_TRANSPORT=http, /mcp + /health) refuses to start without a real CONDUIT_S2S_SECRET (at least 32 characters, not a known or placeholder-looking value, not a repeated pattern, at least 8 distinct characters) and requires a valid X-Gateway-S2S header on every /mcp request. /mcp takes POST only (405 with Allow: POST otherwise). MCP_ALLOWED_HOSTS (comma-separated, off when unset) limits the Host headers /mcp accepts. Every response sets Cache-Control: no-store.

  • AUTH_MODE is gateway (the default when unset) or env. Any other value refuses to start. In gateway mode credentials come only from the x-marketsharp-* headers; MARKETSHARP_* env is never read. env is for a single tenant and reads MARKETSHARP_* from the environment; over HTTP it refuses to start unless the company id, API key and API secret are set and the ids look like MarketSharp ids. Stdio uses the environment only when AUTH_MODE is unset or exactly env; any other value (including a typo) is treated as gateway, so env credentials are never used by mistake.
  • Tool tiers: read is the only tier. Conduit's X-Conduit-Tool-Tiers header can only narrow that set for one request. A present but empty header means no tools at all. Unlike the fleet template there is deliberately no MARKETSHARP_TOOL_TIERS variable: with one tier there is nothing to choose, and nothing in the environment can change the tier set.
  • Every request goes to the fixed host https://restapi.marketsharpm.com at exactly the path that was built. Ids in paths must look like MarketSharp ids (1-64 letters, digits or dashes, which covers numbers and GUIDs); anything else is rejected before any request. Redirects are refused (redirect: 'manual', any 3xx is an error), so the bearer token never leaves the host. Response bodies are read with a 4 MiB cap.
  • Tool output, tool errors and log lines are redacted: the API key and secret in use (env or per request), bearer tokens and JWTs become [REDACTED]. In MarketSharp responses, values under credential-named keys (apiKey, authorization, token, accessToken, refreshToken, and any key ending in password or secret) are redacted too. Arguments a tool doesn't declare are dropped before it runs. Vendor errors keep the HTTP status, MarketSharp's message and, when sent, the request id (x-request-id, request-id or x-correlation-id).
  • Page sizes and record counts above a tool's maximum are rejected, not silently lowered, so "fewer rows than rowsPerPage means the last page" stays true. Pages are passed through as given; the server never fetches more than one page per call.
  • MCP_ALLOW_INSECURE_DEV=1 lets HTTP start without a secret, on 127.0.0.1 only, and requires NODE_ENV=development. With any other NODE_ENV the server refuses to start.
  • Tool output is MarketSharp data that other people may have typed (lead forms, notes, names). Every successful result is escaped and wrapped in <untrusted-content nonce="…"> markers behind a notice telling the model not to follow instructions inside it. MarketSharp's own error text is wrapped the same way.

See .env.example. The image's health check probes /health only when MCP_TRANSPORT=http.

Limits and unknowns

  • MarketSharp doesn't publish rate limits. The server retries 429 with Retry-After or exponential backoff (3 tries). A 503 is retried only for GET requests. Searches and filtered lists (which use POST) return it instead.
  • The /token 200 response shape isn't documented. The server accepts access_token or token, top level or inside response, or a bare JWT body (plain or JSON-quoted).
  • HTTP request bodies are capped at 256 KiB (262,144 bytes). Larger bodies, declared or chunked, get a 413.
  • Responses are capped at 200,000 characters; narrow with filters or paging. An oversized list keeps whole records and its paging fields (also when the page sits under response or data), and a note says how many records were left out. On the paged lists the note names the exact pageNumber and rowsPerPage (page and pageSize for employees) that read on from the first record left out; other tools can't page, so it says to narrow with filters. A list whose first record alone is over the cap is cut as text.
  • The QuickFind searches always send numberOfRecords (default 25): it is a non-nullable int32 in the spec, and what MarketSharp does with 0 is undocumented.
  • Not covered: calendar, texting, email, PaySimple, QuickBooks, CompanyCam, automation rules, analytics, estimates (v1 only), and all admin/config writes.

Security notes

  • companyId and employeeId are identifiers, not secrets. The companies tools return them by design.
  • MCP_ALLOWED_HOSTS is opt-in defence in depth behind S2S, not an auth control. It matches the Host header's hostname and ignores the port.
  • The S2S signature covers only the timestamp, the same as the gateway's verifier. Recipient binding comes from the per-vendor subkey.
  • MCP_ALLOW_INSECURE_DEV must never be set in a deployment.
  • A request has at most 4 MarketSharp calls in flight, each counted from the start of the fetch until its response body is fully read. A large JSON-RPC batch queues instead of fanning out. A retry's wait doesn't hold a slot.

Development

npm ci --ignore-scripts
npm run typecheck        # tsc --noEmit
npm run lint             # eslint + destructive-tool warning lint
npm run lint:destructive # destructive-tool warning lint only
npm run build
npm test                 # vitest, no network
npm run smoke            # spawns dist/index.js over stdio, no network

evals/ holds the mcp-assert suite that CI runs against the built server.

Each release publishes ghcr.io/wyre-ai/marketsharp-mcp, and its release notes are on the GitHub Release for that version.

License

Apache-2.0

Reviews

No reviews yet

Be the first to review this server!