Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Description from the maker (original English)
Manage Freshsales contacts, accounts, deals, tasks and appointments; add notes.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
Passed 4/4 checks · What you ask goes through the maker’s server (freshsales.usefulapi.io)
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
Freshsales MCP by usefulapihttps://freshsales.usefulapi.io/mcpLeave Authentication as Claude detected it, then click Add
+ConnectorsFreshsales MCP by usefulapi
Use Freshsales MCP by usefulapi and tell me what you can do for me, then show me one thing✓ If Claude says it is using Freshsales MCP by usefulapi or shows a Freshsales MCP by usefulapi tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT on business plans only
ChatGPT Business, Enterprise or Edu on the web, added by a workspace admin or owner · On Free, Plus or Pro: your ChatGPT plan cannot connect MCP yet
Plugins+Add custom MCP server
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Freshsales MCP by usefulapihttps://freshsales.usefulapi.io/mcpStart a new chat and pick Freshsales MCP by usefulapi from your plugins before typing
Use Freshsales MCP by usefulapi and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using Freshsales MCP by usefulapi or shows a Freshsales MCP by usefulapi tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http freshsales https://freshsales.usefulapi.io/mcpYou should see Freshsales MCP by usefulapi listed as connected
Use Freshsales MCP by usefulapi and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Freshsales MCP by usefulapi or shows a Freshsales MCP by usefulapi tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Use Freshsales MCP by usefulapi and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Freshsales MCP by usefulapi or shows a Freshsales MCP by usefulapi tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Use Freshsales MCP by usefulapi and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Freshsales MCP by usefulapi or shows a Freshsales MCP by usefulapi tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://freshsales.usefulapi.io/mcpJSON settings are under “For developers” below
Claude Code
claude mcp add --transport http freshsales https://freshsales.usefulapi.io/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"freshsales": {
"url": "https://freshsales.usefulapi.io/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"freshsales": {
"type": "http",
"url": "https://freshsales.usefulapi.io/mcp"
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.
freshsales_list_contact_viewsList the saved contact views (filters) of the account, e.g. 'My Contacts', 'New Contacts', 'All Contacts'. A view id is needed by freshsales_list_contacts; ids differ per account. GET /contacts/filters.
freshsales_list_contactsList the contacts in a view (get view_id from freshsales_list_contact_views), 25 per page with name, email, phone numbers, job title, lead score, open deals amount and last contacted. Pages: use next_page. GET /contacts/view/{view_id}.
freshsales_get_contactOne contact by id with all its fields, optionally with related records embedded via include (notes, tasks, appointments, deals, sales_accounts, owner, sales_activities...). GET /contacts/{id}.
freshsales_searchSearch by name/email text across one record type: contact, sales_account (company), deal or user. Returns id, type, name and email for the matches (up to per_page, default 10). Use the id with the get tools. GET /search.
freshsales_lookupExact-match lookup of contacts, companies or deals by one field, e.g. a contact by email address. field is 'email' (contacts), 'name', or a custom field name (cf_...). Returns the full records. GET /lookup.
freshsales_list_account_viewsList the saved account (company) views of the account, e.g. 'My Accounts'. A view id is needed by freshsales_list_accounts. GET /sales_accounts/filters.
freshsales_list_accountsList the accounts (companies) in a view (view_id from freshsales_list_account_views), 25 per page, with name, location, open deals amount and last contacted. GET /sales_accounts/view/{view_id}.
freshsales_get_accountOne account (company) by id with its fields, optionally with related records embedded (contacts, deals, tasks, appointments, owner...). GET /sales_accounts/{id}.
freshsales_list_deal_viewsList the saved deal views of the account, e.g. 'Open Deals'. A view id is needed by freshsales_list_deals. GET /deals/filters.
freshsales_list_dealsList the deals in a view (view_id from freshsales_list_deal_views), 25 per page, with name, amount, expected close, probability and age. GET /deals/view/{view_id}.
freshsales_get_dealOne deal by id with amount, expected close, probability and ids of its stage, pipeline and owner, optionally with related records embedded (contacts, sales_account, deal_stage, owner, notes via sales_activities...). GET /deals/{id}.
freshsales_list_tasksList tasks by status filter: open, due_today, due_tomorrow, overdue or completed (one filter per call). Returns title, due date, owner and status. GET /tasks.
freshsales_get_taskOne task by id. GET /tasks/{id}.
freshsales_list_appointmentsList appointments that are open (upcoming) or complete (one filter per call), with title, time, location and creator. GET /appointments.
freshsales_get_appointmentOne appointment by id with its attendees. GET /appointments/{id}.
freshsales_list_sales_activitiesList logged sales activities (calls, meetings, emails...) of the account. GET /sales_activities.
freshsales_list_ownersList the users of the account (id and name). Use the id as owner_id when creating or updating records. GET /selector/owners.
freshsales_list_deal_pipelinesList the deal pipelines (id, name). GET /selector/deal_pipelines.
freshsales_list_deal_stagesList deal stages (id, name, deal_pipeline_id): those of the default pipeline, or of the pipeline given by pipeline_id. Use the id as deal_stage_id. GET /selector/deal_stages or /selector/deal_pipelines/{id}/deal_stages.
freshsales_list_optionsList the configured choices (id and name) for a field: lead_sources, contact_statuses, lifecycle_stages, deal_types, deal_reasons, deal_products, deal_payment_statuses, territories, currencies, industry_types, business_types, campaigns, sales_activity_types, sales_activity_outcom
freshsales_create_contactWRITE: create a contact. Freshsales requires an email or a mobile number. It may create a duplicate of an existing contact: search first (freshsales_lookup by email). POST /contacts.
freshsales_update_contactWRITE: change fields of an existing contact; only the fields you pass are changed (passing sales_accounts replaces the associated companies). PUT /contacts/{id}.
freshsales_create_accountWRITE: create an account (company). name is required. It may duplicate an existing company: search first (freshsales_search). POST /sales_accounts.
freshsales_update_accountWRITE: change fields of an existing account (company); only the fields you pass are changed. PUT /sales_accounts/{id}.
freshsales_create_dealWRITE: create a deal. name, amount and sales_account_id are required; contact_ids attach existing contacts. Stage and pipeline default to the first of the default pipeline. POST /deals.
freshsales_update_dealWRITE: change fields of an existing deal, e.g. move it to another stage (deal_stage_id), change amount or expected close; only the fields you pass are changed. PUT /deals/{id}.
freshsales_create_noteWRITE: add a note to a contact, account or deal. Visible to your team on the record. POST /notes.
freshsales_update_noteWRITE: replace the text of an existing note. PUT /notes/{id}.
freshsales_create_taskWRITE: create a task (to-do) attached to a contact, account or deal. title, due_date, owner_id and the target are required. POST /tasks.
freshsales_update_taskWRITE: change a task: title, details, due date, owner, or mark it completed (status 1) or open (status 0). PUT /tasks/{id}.
freshsales_create_appointmentWRITE: create an appointment (meeting) with a start and end, optionally attached to a contact, account or deal and with attendees. Attendees may be notified by Freshsales. POST /appointments.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026
The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)
Code last changed today
We have not read this repo from GitHub yet
Responded in 13 ms (HTTP 200)
No sign-in needed
Read 31 tool descriptions and found no hidden instructions to the AI
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed today, and the latest version (1.16.3) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Use Freshsales from Claude, Cursor, or any MCP client — work with your contacts, accounts, deals, tasks and appointments. Hosted, no local install: connect with your own Freshsales credentials.
Live endpoint: https://freshsales.usefulapi.io/mcp · Homepage: https://usefulapi.io/freshsales
https://freshsales.usefulapi.io/mcp.claude mcp add --transport http freshsales https://freshsales.usefulapi.io/mcp, then run /mcp to log in.{
"mcpServers": { "freshsales": { "url": "https://freshsales.usefulapi.io/mcp" } } }
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Freshsales credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/freshsales/
On first connect you'll enter your Freshsales domain and API key (Freshsales Profile Settings → API Settings). They are validated, stored per-user, and scoped to you — no keys in config files.
| Tool | Type | What it does |
|---|---|---|
freshsales_list_contact_views | read | List contact views |
freshsales_list_contacts | read | List contacts |
freshsales_get_contact | read | Get contact |
freshsales_search | read | Search records |
freshsales_lookup | read | Look up by exact field |
freshsales_list_account_views | read | List account views |
freshsales_list_accounts | read | List accounts |
freshsales_get_account | read | Get account |
freshsales_list_deal_views | read | List deal views |
freshsales_list_deals | read | List deals |
freshsales_get_deal | read | Get deal |
freshsales_list_tasks | read | List tasks |
freshsales_get_task | read | Get task |
freshsales_list_appointments | read | List appointments |
freshsales_get_appointment | read | Get appointment |
freshsales_list_sales_activities | read | List sales activities |
freshsales_list_owners | read | List owners (users) |
freshsales_list_deal_pipelines | read | List deal pipelines |
freshsales_list_deal_stages | read | List deal stages |
freshsales_list_options | read | List option values |
freshsales_create_contact | write | Create contact |
freshsales_update_contact | write | Update contact |
freshsales_create_account | write | Create account |
freshsales_update_account | write | Update account |
freshsales_create_deal | write | Create deal |
freshsales_update_deal | write | Update deal |
freshsales_create_note | write | Add note |
freshsales_update_note | write | Update note |
freshsales_create_task | write | Create task |
freshsales_update_task | write | Update task |
freshsales_create_appointment | write | Create appointment |
freshsales_usage_status | meta | Usage status (free-tier meter) |
freshsales_request_feature | meta | Request a missing feature |
freshsales_upgrade | meta | Upgrade to Pro or Pro+ |
freshsales_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per account) | $9/mo or $90/yr (2 months free) | Unlimited* |
\*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.
Pro covers this server only. Subscribe with freshsales_upgrade (it returns a Stripe Checkout link). Cancel any time with freshsales_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running freshsales_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
MIT — see LICENSE. Documentation only; the server is hosted.