@workos/mcp-docs-server

v0.1.0 · 4 tools · source

[ tools: 4 ][ checks: 11 ][ latency: 4ms ]

83/100(B)

npx -y @workos/mcp-docs-server

check breakdown

✓Tools exposed — Server exposed 4 tools.

• workos_docs

• workos_search

• workos_examples

• workos_changelogs

✓Input schemas valid — All tools have a valid JSON-Schema input definition.

!Input schema quality — 4 schema-quality issue(s) across 4 tool(s).

workos_docs: inputSchema.additionalProperties is not set to false (extra args pass through silently)

workos_search: inputSchema.additionalProperties is not set to false (extra args pass through silently)

workos_examples: inputSchema.additionalProperties is not set to false (extra args pass through silently)

workos_changelogs: inputSchema.additionalProperties is not set to false (extra args pass through silently)

→ Declare `required` for every schema that has properties, so agents know which params are mandatory.

→ Give every property a `description` and a concrete `type` (avoid bare `{}` placeholders).

→ Set `additionalProperties: false` on the top-level inputSchema so models can't silently pass extra, unvalidated arguments.

!Output schemas — No tools declare an outputSchema.

→ Optional: declare outputSchema for tools with structured results so agents can validate/parse output reliably.

✓Duplicate tool names — All tool names are unique.

✓Tool naming — All tool names use spec-legal characters.

✓Descriptions — Every tool and parameter is clearly described.

!Tool annotations — Annotation coverage 0% (0/20 hint fields set).

• workos_docs: no annotations at all

• workos_search: no annotations at all

• workos_examples: no annotations at all

• workos_changelogs: no annotations at all

→ Add annotations: title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint.

→ These let clients gate risky calls and give agents/users a friendly display name — optional but valuable.

!Tool titles — 4 of 4 tool(s) have no title.

• workos_docs: no top-level title (or annotations.title)

• workos_search: no top-level title (or annotations.title)

• workos_examples: no top-level title (or annotations.title)

• workos_changelogs: no top-level title (or annotations.title)

→ Declare a top-level `title` on each tool — it gives clients a friendly display name distinct from the machine-readable `name`.

→ `annotations.title` (the older location) is also accepted, but the top-level `title` field is now the spec-preferred place for it.

!Server instructions — No top-level instructions declared.

→ Declare instructions to guide agents on when/how to use this server.

→ Return a non-empty `instructions` string in your InitializeResult — most SDKs let you set this alongside serverInfo.

✓Handshake + list latency — tools/list responded in 4ms.

Paste into your README:

[![scoremcp](https://scoremcp.dev/badge/workos-docs-mcp)](https://scoremcp.dev/servers/workos-docs-mcp)