Skip to content

fix: mcp card #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
antlio merged 2 commits into from
Jul 3, 2026
Merged

fix: mcp card #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
951e591
fix(agent-protocols): make mcp server card check optional
antlio Jul 3, 2026
f4acee6
chore: add changeset for optional mcp server card check
antlio Jul 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .changeset/mcp-card-optional.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
"agentimization": patch
"@agentimization/core": patch
---

make the MCP server card check optional so content sites aren't penalized:

- an absent `/.well-known/mcp/server-card.json` now reports `info` instead of `fail`, so it no longer drags down the score (matches how the sibling `api-catalog` and `mcp-tool-count` checks already treat absent origin-level signals). A present-but-broken card still `warn`s and a valid one still `pass`es.
- show the suggestion arrow for `info` results in the CLI so the "add a server-card.json" hint stays visible (also surfaces previously-hidden suggestions on `api-catalog`, content-signals, and link-headers).
2 changes: 1 addition & 1 deletion apps/cli/src/ui/check-list.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ const CheckLine = ({ check, loaderColor }: { check: CheckState; loaderColor?: st
const r = check.result
const icon = STATUS_ICONS[r.status] ?? "?"
const color = STATUS_COLORS[r.status] ?? "white"
const showSuggestion = r.suggestion && (r.status === "fail" || r.status === "warn")
const showSuggestion = r.suggestion && (r.status === "fail" || r.status === "warn" || r.status === "info")

return (
<Box flexDirection="column" paddingLeft={2}>
Expand Down
4 changes: 2 additions & 2 deletions packages/core/src/checks/agent-protocols.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ const mcpServerCard: CheckDefinition = {
id: "mcp-server-card",
name: "MCP Server Card",
category: "agent-protocols",
status: "fail",
message: "No MCP server card found at /.well-known/mcp/server-card.json",
status: "info",
message: "No MCP server card found at /.well-known/mcp/server-card.json (optional)",
suggestion: "Add a server-card.json at /.well-known/mcp/server-card.json describing your MCP server's tools, authentication, and capabilities. This lets AI agents discover what they can do with your site before connecting.",
}
}
Expand Down
Loading