MarketSharp has a read-only OData API that account admins enable under API Maintenance (checked 11 Oct 2026). Cotlet is a hosted MCP server and REST API for MarketSharp with 14 endpoints (6 read, 8 write): your AI agent signs in as you and does the work.
MarketSharp has a read-only OData API that account admins enable under API Maintenance (checked 11 Oct 2026). Its REST API, the only way to write data, is reserved for approved partners who serve at least 20 MarketSharp customers, after an NDA and legal review.
What MarketSharp's own tools do compared with Cotlet
Task
MarketSharp official
Cotlet
Search leads and customers
YesRead-only OData, keys from your admin
Yes
Read appointments and results
YesRead-only OData
Yes
Read job and contract status
YesRead-only OData
Yes
Add a new lead
PartlyCustom Lead Capture form post or Zapier, one way
Cotlet is best for home improvement contractors and their office managers who want an AI agent to add leads, book appointments and result them in MarketSharp without running or fixing a server.
Go through the lead emails that came in since yesterday. For each homeowner, check MarketSharp for an existing contact, add new ones as leads with the right lead source and product interest, and book a sales appointment with the salesperson I name, at a time that does not clash with their calendar. Your agent calls search_contacts, get_contact, list_appointments, create_lead and schedule_appointment.
Find last week's sales appointments that still have no Appt Result. For each one, ask me or the rep what happened, set the result, add the rep's note to the contact, and tell me if the follow-up activities from our Appointment Rules did not show up. Your agent calls list_appointments, get_contact, result_appointment and add_note.
Find appointments with no result Runs: Daily
Which of last week's sales appointments still have no result? Your agent calls list_appointments.
Report sold jobs and contract status Runs: Weekly
List jobs sold this month with their contract status and start date. Your agent calls list_jobs and get_job.
Create follow-up calls for lost appointments Runs: Daily
Create a follow-up call activity for every lead whose appointment ended without a sale. Your agent calls list_appointments and add_activity.
Email tomorrow's appointments to salespeople Runs: Daily
Email tomorrow's appointments to the salespeople. Your agent calls list_appointments and issue_appointments.
Endpoints
What is the MarketSharp API?
Cotlet's MarketSharp API exposes 14 endpoints for your own MarketSharp account: search contacts, get contact, list appointments, list jobs, get job, list activities, create lead, schedule appointment, result appointment, add note, add activity, complete activity, update job status and issue appointments. The search_contacts endpoint returns find prospects, leads and customers by name, phone, email or address, like Quick Find. Each endpoint takes simple JSON inputs like contact_id, limit or salesperson and works both as an MCP tool for agents and as a REST call for scripts.
Find prospects, leads and customers by name, phone, email or address, like Quick Find.
read
Searches your MarketSharp contacts the way Quick Find does and returns the best matches first. Use contact_id from each item in get_contact and the write tools. Pages hold up to 100 contacts.
Full contact record: phones, addresses, inquiries, appointments, jobs, notes and open activities.
read
Returns one contact with its phones, addresses, inquiries, appointments, jobs, notes and open activities. Use it before writing, so your agent sees what is already there. IDs in the result feed the other tools.
Sales appointments in a date range with contact, salesperson, set by and Appt Result.
read
Lists sales appointments between two dates, earliest first. Set unresulted_only to see the visits that still need an Appt Result. Result is empty until someone sets it.
Jobs with job number, customer, job status, contract status, sale date and start date.
read
Lists jobs, newest sale first, with job number, customer, Job Status, Contract Status, sale date and start date. Filter by sale date or by one of your own Job Status values. Pages hold up to 200 jobs.
The Activity List: to-dos for a user and date, with type, contact and due date.
read
Returns the Activity List for one user and day: type, contact, reference and due date. Open activities only, unless include_completed is set. Use activity_id with complete_activity.
New lead with contact details and an inquiry, optionally with a sales appointment.
asks first write
Creates a lead with an inquiry in your MarketSharp account. A first name, a last name, and an email or a phone number are required. With appointment_at set, a sales appointment is added to the Sales Calendar. Source and product values must exist in your lists. By default you confirm each call; you can switch that off for this tool.
Add a sales appointment to a contact's inquiry; it appears on the Sales Calendar.
asks first write
Adds a sales appointment to an inquiry, the latest one unless inquiry_id is set. It appears on the Sales Calendar for the chosen salesperson. By default you confirm each call; you can switch that off for this tool.
Set the Appt Result after the visit. A result marked Sold converts the lead to a customer.
asks first write
Sets the Appt Result of one appointment to one of your company's own options. A result marked Sold converts the lead to a customer, and the response says what to do next. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/marketsharp/result_appointment
Input
Input: result_appointment
Parameter
Type
Description
appointment_id required
string
Appointment ID from get_contact or list_appointments.
result required
string
One of your company's Appt Result options.
Example response
{
"appointment_id": "a7f3c2e1-5b8d-4e0a-9c61-2d4f8b7e1a90",
"contact_id": "3e9b1d44-0c27-4f5a-8e13-6a2b9c0d7f58",
"result": "Sold",
"sold": true,
"contact_type": "customer",
"next_step": "Create a job for this customer"
}
POST
add_note
Add a note to the Notes tab of a contact.
asks first write
Adds a note to the Notes tab of one contact, under your name. There is no tool to delete a note, so each call asks first. By default you confirm each call; you can switch that off for this tool.
Add a follow-up activity to a contact and assign it to a user.
asks first write
Adds an activity of one of your Activity Types to a contact and assigns it to a user, who sees it in the Activity List. By default you confirm each call; you can switch that off for this tool.
Change a job's Job Status or Contract Status, for example to Canceled.
asks first write
Changes the Job Status, the Contract Status or both to values from your own lists. A change like Canceled affects a customer's contract, so the call asks first. By default you confirm each call; you can switch that off for this tool.
Email and issue appointments to the assigned salespeople, using one of your Issue Appointment templates.
asks first write
Issues the appointments you pass and emails each assigned salesperson with one of your Issue Appointment templates, or your default one. The emails reach your team. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/marketsharp/issue_appointments
Input
Input: issue_appointments
Parameter
Type
Description
appointment_ids required
string[]
Appointments from list_appointments.
template
string
Issue Appointment email template name. Default: your default template.
How do I connect MarketSharp to Claude Code, Codex or Cursor?
Connecting MarketSharp takes three steps: request access, sign in to MarketSharp once, then add one MCP server or call the REST API with the same key.
Connect MarketSharp over MCP
1
Create an account
Sign up and add MarketSharp in the console. Your API key is there too.
2
Sign in to MarketSharp once
Open the connect page from the console and sign in to MarketSharp the way you always do. We keep the session, never your password, and you can revoke it anytime.
Paste the snippet for your client. The same server and key serve every app you connect, so you do this once.
4
Ask your agent
Prompt
Go through the lead emails that came in since yesterday. For each homeowner, check MarketSharp for an existing contact, add new ones as leads with the right lead source and product interest, and book a sales appointment with the salesperson I name, at a time that does not clash with their calendar.
Ask in plain words. Your agent finds the MarketSharp tools on the server and calls them for you; anything that reaches other people waits for your OK unless you switch that off for a tool.
Call MarketSharp over REST
1
Export your API key
Shell
export COTLET_API_KEY="cotlet_..."
Your scripts use the same API key as your agent. Keep it in an environment variable, never in your code.
Every tool is a POST endpoint at /api/v1/marketsharp/{tool}. Send its parameters as JSON, exactly as listed in the endpoints above.
3
Read the result
Example response · result_appointment
{
"appointment_id": "a7f3c2e1-5b8d-4e0a-9c61-2d4f8b7e1a90",
"contact_id": "3e9b1d44-0c27-4f5a-8e13-6a2b9c0d7f58",
"result": "Sold",
"sold": true,
"contact_type": "customer",
"next_step": "Create a job for this customer"
}
You get plain JSON back, ready for your script. A failed call costs nothing.
Why Cotlet
Why use Cotlet for MarketSharp? Hosted, safe and kept working.
Built for agents
One MCP server for every app you connect.
The same tools as a REST API for scripts and cron jobs.
Works with Claude Code, Codex and Cursor.
Your login stays yours
You sign in to MarketSharp yourself. We keep only the session, encrypted with AES-256.
The model never sees a login.
No stored passwords, no CAPTCHA solving, no MFA bypass.
You stay in control
Pick read only, or read and write.
Anything that reaches other people waits for your OK, unless you switch it off per tool.
Revoke access in one click.
Kept working for you
We test every integration daily.
When MarketSharp changes, the tool pauses until we fix it.
Failed calls cost nothing.
Alternatives
Is there a MarketSharp MCP server on GitHub?
The MarketSharp app on Zapier has one action, Submit Lead, which feeds new leads in through a Custom Lead Capture; it cannot read or update anything.
Cotlet compared with a Zapier
Zapier
Cotlet
Setup
Create a Custom Lead Capture in MarketSharp Admin, then build a Zap
Request access, sign in to MarketSharp once, add one MCP server or API key
What it can do
Submit Lead only, no triggers
Search, read and update contacts, appointments, jobs, notes and activities
Reading your data
Not available
Contacts, appointments, jobs and contract status
When the session expires
Not needed, the form post uses your company ID
We keep it alive; if MarketSharp logs you out, your agent gets a link to sign in again
Where it runs
Zapier cloud, started by another app
Hosted: Claude Code, Codex, Cursor and scripts
Price
Your Zapier plan; tasks are counted by Zapier
Free 7-day trial with 5,000 credits, then credits per call
Which one fits you
Pick Cotlet if
you are not a developer, or you do not want to maintain a server
you need it to keep working when MarketSharp changes, without checking it yourself
your agent or a script should run it on a schedule, also while your computer is off
Pick an open-source server if
you are comfortable installing, updating and fixing it yourself
you want the session to stay on your own computer
you only need it now and then, from one MCP client
For AI agents
Cotlet for MarketSharp in plain text The facts on this page in one block: status, endpoints, access, pricing, contact.
Endpoint health
verified 2h ago
search_contactspassing
get_contactpassing
list_appointmentspassing
list_jobspassing
get_jobpassing
+ 9 more endpoints
14/14 passing latest checkself-healing
marketsharp.txt
MarketSharp has a read-only OData API that account admins enable under API Maintenance (checked 11 Oct 2026). Its REST API, the only way to write data, is reserved for approved partners who serve at least 20 MarketSharp customers, after an NDA and legal review.
Cotlet provides a hosted MCP server and REST API for MarketSharp: 14 tools (6 read, 8 write).
Access Request access at https://cotlet.dev/app/signup?app=marketsharp; we email the API key.
MCP server https://cotlet.dev/mcp/v1
REST base https://cotlet.dev/api/v1/marketsharp
Auth Authorization: Bearer <COTLET_API_KEY>. Listing endpoints and schemas needs no key; calling an endpoint needs one.
Tools search_contacts, get_contact, list_appointments, list_jobs, get_job, list_activities, create_lead, schedule_appointment, result_appointment, add_note, add_activity, complete_activity, update_job_status, issue_appointments
Confirm create_lead, schedule_appointment, result_appointment, add_note, add_activity, complete_activity, update_job_status, issue_appointments (by default the user approves each call; the user can switch this off per tool, e.g. for scheduled automations)
Markdown https://cotlet.dev/integrations/marketsharp-api-mcp-server.md
How access works:
1. The user requests access at https://cotlet.dev/app/signup?app=marketsharp (MarketSharp is pre-selected). Each request is reviewed and the API key is sent by email.
2. The user signs in to MarketSharp once in a browser. An agent cannot do this step.
3. The API key goes into the MCP client or the REST call as a bearer token.
Fits: people who want a hosted MarketSharp server that someone else maintains, including non-developers.
Policy: Cotlet never stores passwords, never solves CAPTCHAs, never bypasses MFA.
Company: legal details in the Terms of service at https://cotlet.dev/terms. Contact contact@cotlet.dev.
Session: the user signs in to MarketSharp in a browser; Cotlet keeps only the session, AES-256 encrypted, revocable in the dashboard at any time.
Terms: the user stays responsible for following MarketSharp's terms; Cotlet is not affiliated with MarketSharp.
Can MarketSharp automations run on a schedule in n8n, Make or Zapier?
Yes. Cotlet does not replace your automation platform: it gives it a MarketSharp connection it does not have, with the same API key as your agent. Write actions ask for your OK by default; switch that off in your dashboard for the tools you choose, for example to add leads from email and book the sales appointment, and the schedule runs on its own. Cotlet runs in the cloud, so it keeps going while your computer is off.
Where to run MarketSharp automations through Cotlet, and how to schedule them
Where
How to connect
How to schedule
Your AI agent
Add https://cotlet.dev/mcp/v1 with your API key.
A scheduled agent run, for example a Claude Code routine.
n8n
MCP Client node with https://cotlet.dev/mcp/v1, or an HTTP Request node to https://cotlet.dev/api/v1/marketsharp/{tool}.
Schedule Trigger node.
Make
HTTP module: POST https://cotlet.dev/api/v1/marketsharp/{tool} with an Authorization: Bearer header and a JSON body.
Scenario schedule.
Zapier
Webhooks by Zapier: POST https://cotlet.dev/api/v1/marketsharp/{tool} with the same header and body.
Schedule by Zapier trigger.
Your own script
POST https://cotlet.dev/api/v1/marketsharp/{tool} with your API key.
cron or GitHub Actions.
Pricing & limits
How much does the MarketSharp API cost?
Free 7-day trial with 5,000 credits, no card needed. After that, the MarketSharp API comes with the Cotlet plan, from $29 a month for 3,000 credits, with no limit on apps. Each month's credits stay valid for 3 months, so unused credits add up.
Cotlet plan sizes: price, monthly credits and price per credit
Size
Price
Credits / month
Per credit
Solo
$29/mo
3,000
about $0.0097
Pro
$99/mo
12,000
about $0.0083
Agency
$299/mo
40,000
$0.0075
Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.
About Cotlet
How Cotlet holds your access
Cotlet hosts MCP servers and REST APIs for apps with no usable API. Your agent works in your own MarketSharp account.
Company details
The legal name, address and registration numbers of the company behind Cotlet are in the Terms of service. Terms
Your session
You sign in to MarketSharp yourself, in your browser. We keep only the session, never your password: encrypted with AES-256 in an EU vault, isolated to your account and used only when your agent calls a MarketSharp tool you allowed. When it expires, your agent gives you a link to sign in again. Security
Revoking access
Disconnect MarketSharp in your dashboard: the session is deleted and access ends at once. Actions that reach other people wait for your OK unless you switch that off per tool.
What we never do
Store passwords, solve CAPTCHAs or bypass MFA.
MarketSharp's terms
You use your own MarketSharp account and stay responsible for following MarketSharp's terms. Cotlet is independent and not affiliated with MarketSharp. Terms
Request access and pick MarketSharp. Cotlet reviews each request and emails you your API key.
Do I need to be technical?
No. You sign in to MarketSharp once in your browser and paste one command into your agent, or one URL into n8n. Your agent can walk you through it. There is no server to install, update or fix.
Is a hosted server safe? My MarketSharp session would leave my computer.
Cotlet keeps your MarketSharp session encrypted with AES-256 in an EU vault, isolated to your account and used only for the tools you allow: read only, or read and write. The AI model never sees it, and you revoke it in one click. A local server keeps the same session in a file on your computer, readable by any program you run, and needs a fresh sign-in whenever it expires.
Do I need an admin to enable the MarketSharp API?
Not for Cotlet. It works in your own MarketSharp user account and does not use the OData API, which an account admin enables under API Maintenance (checked 11 Oct 2026).
Can my agent post or send messages in MarketSharp without asking me?
No. Every call to create_lead, schedule_appointment, result_appointment, add_note, add_activity, complete_activity, update_job_status or issue_appointments waits for your OK by default. For scheduled automations you can switch confirmation off per tool in your dashboard, for example only for approvals.
Can I use the MarketSharp API in n8n?
Yes. Add https://cotlet.dev/mcp/v1 with your API key in n8n's MCP Client node, or call https://cotlet.dev/api/v1/marketsharp/{tool} from the HTTP Request node.
