Skip to content

Add Customermates MCP server (remote, streamable HTTP) - #707

Open
benjiwagner wants to merge 3 commits into
Kilo-Org:mainfrom
benjiwagner:add-customermates-mcp
Open

benjiwagner wants to merge 3 commits into
Kilo-Org:mainfrom
benjiwagner:add-customermates-mcp

Conversation

@benjiwagner

@benjiwagner benjiwagner commented Nov 13, 2026 •

Copy link
Copy Markdown

Adds the Customermates MCP server as a remote streamable HTTP entry (endpoint https://customermates.com/api/v1/mcp, x-api-key header, documented at https://customermates.com/docs/mcp). Customermates is a source-available CRM (https://github.com/customermates/customermates); self-hosted instances use their own base URL. No CRM entry exists in mcps/ yet. The entry follows the format of the existing remote entries (for example neon and context7).

@kilo-code-bot kilo-code-bot Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the new Customermates MCP entry.

content: |
{
"type": "streamable-http",
"url": "https://customermates.com/api/v1/mcp",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: Advertised self-hosting cannot be configured

The description and the prerequisite both state this server works against a self-hosted Customermates instance, but the only installation config hardcodes the hosted endpoint https://customermates.com/api/v1/mcp. A self-hosted user installing from the marketplace is silently pointed at the cloud service, and their self-hosted API key will fail or address the wrong workspace.

Other remote entries parameterize the host for exactly this reason, for example mcps/datadog-mcp-datadoghq/MCP.yaml uses https://{{DATADOG_MCP_HOST}}/v1/mcp with a hostname parameter. Minimal fix: change this to "url": "https://{{CUSTOMERMATES_HOST}}/api/v1/mcp" and add a Customermates host parameter with placeholder customermates.com (or drop the self-hosted wording from the description and prerequisites).

@kilo-code-bot

kilo-code-bot Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • mcps/customermates/MCP.yaml

Notes

  • Incremental change at 3d53282 only removes the "Open-source" wording from the description, matching the 2026-11-20 move to a source-available Sustainable Use License. No other open-source claim remains in the entry.
  • The earlier hosted-vs-self-hosted mismatch is resolved: the description and prerequisite now scope this entry to customermates.com, which is the endpoint the installation config uses. The previous inline comment on line 14 is outdated and requires no action.
  • Static checks: id matches the directory name, category: productivity is a supported category, no duplicate MCP id, {{CUSTOMERMATES_API_KEY}} appears only in the request header, and no secret is committed.
  • Unverified in this sandbox (no network access): that https://customermates.com/api/v1/mcp is the live documented endpoint, that x-api-key is the correct header, that keys are 64 characters as the placeholder states, and that https://github.com/customermates/customermates is the canonical public source. The maintainer should confirm these against https://customermates.com/docs/mcp before merge.
  • mcps/marketplace.yaml is not updated in this PR; confirm the catalog is regenerated by the repository workflow after merge, as with other MCP additions.
Previous Review Summaries (2 snapshots, latest commit 38846e3)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 38846e3)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • mcps/customermates/MCP.yaml

Notes

  • The description and prerequisite now consistently scope this entry to the hosted customermates.com app, matching the hardcoded endpoint.
  • Unverified in this sandbox (no network access): that https://customermates.com/api/v1/mcp is the live documented endpoint, that x-api-key is the correct header, that keys are 64 characters as the placeholder claims, and that https://github.com/customermates/customermates is the canonical public source with a license. Maintainer should confirm against https://customermates.com/docs/mcp before merge.
  • mcps/marketplace.yaml is intentionally not updated here; the Generate Marketplace workflow regenerates and commits it.

Previous review (commit d162965)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
mcps/customermates/MCP.yaml 14 Description and prerequisites advertise self-hosted Customermates, but the installation config hardcodes https://customermates.com/api/v1/mcp. A self-hosted user is pointed at the cloud endpoint and their key fails. Parameterize the host (e.g. https://{{CUSTOMERMATES_HOST}}/api/v1/mcp, as mcps/datadog-mcp-datadoghq/MCP.yaml does) or remove the self-hosted claims.

Notes

  • Verified: id matches the directory name, category productivity is a valid marketplace category, no duplicate MCP id, YAML parses, placeholder {{CUSTOMERMATES_API_KEY}} is used only in the header, no secrets committed.
  • Unverified in this sandbox (no network access): that https://customermates.com/api/v1/mcp is the live documented endpoint, that the x-api-key header name is correct, that keys are 64 characters as the placeholder claims, and that https://github.com/customermates/customermates is the canonical public source with a license. Maintainer should confirm these against https://customermates.com/docs/mcp before merge.
  • mcps/marketplace.yaml is intentionally not updated here; the Generate Marketplace workflow regenerates and commits it.

Fix these issues in Kilo Cloud

Files Reviewed (1 file)
  • mcps/customermates/MCP.yaml - 1 issue

Reviewed by deepseek-v4.1-flash-1017 · Input: 43.4K · Output: 9.3K · Cached: 792.3K

Review guidance: REVIEW.md from base branch main

@benjiwagner

Copy link
Copy Markdown
Author

Thanks for the review. The entry now covers only the hosted endpoint it installs: the self-hosted wording is gone from the description and the prerequisite, so nobody with a self-hosted key is pointed at the cloud service. Endpoint, header name and key length match https://customermates.com/en/docs/mcp.

@benjiwagner

benjiwagner commented Nov 20, 2026 •

Copy link
Copy Markdown
Author

Update: Customermates is a source-available CRM under the Sustainable Use License; I have updated the entry accordingly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant