Skip to main content
Glama
mcpindex-ai

mcp-server-mcpindex

Official
by mcpindex-ai

mcp-server-mcpindex

mcpindex npm npm downloads servers indexed screened last commit Smithery Glama

MCP-сервер для поиска MCP-серверов, а также рекомендательные вердикты доверия, которые агентные фреймворки могут вызывать перед вызовом инструмента — от mcpindex.ai.

Готовый MCP-сервер, который позволяет вашему агенту обнаруживать, сравнивать, устанавливать и предварительно проверять другие MCP-серверы прямо внутри агентного цикла. Работает на базе mcpindex.ai — агентно-ориентированного индекса MCP-серверов официального реестра (актуальное количество на mcpindex.ai/stats), ежедневно проверяемого и отслеживаемого на расхождения.

Живой сайт · npx mcp-server-mcpindex · Удалённый MCP · Установка · Документация · Доверие

Установка

npm install -g mcp-server-mcpindex

Это каталоговый / рекомендательный клиент (рекомендации, поиск, доверие). Он не устанавливает внутрипутевой шлюз контроля расхождений — для этого используется curl -fsSL https://mcpindex.ai/install.sh | sh.

Требуется Node 20+. Работает с обеими эпохами протокола через stdio: ревизия 2026-07-28 (server/discover, обёртка _meta на каждый запрос) и рукопожатие initialize, которое использует каждый современный клиент (с 2025-11-25 до 2024-10-07), выбирается для каждого соединения.

Или подключитесь удалённо (без установки)

Не хотите ничего устанавливать? mcpindex также является хостируемым удалённым MCP-сервером. Укажите любой клиент, поддерживающий удалённый MCP (коннекторы Claude, Cursor и т.д.), на адрес:

https://mcpindex.ai/api/mcp

Claude Code

claude mcp add --scope user mcpindex -- npx -y mcp-server-mcpindex@latest

Gemini CLI

gemini mcp add -s user mcpindex npx -y mcp-server-mcpindex@latest

Related MCP server: filesystem-mcp

Использование из Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcpindex": {
      "command": "npx",
      "args": ["-y", "mcp-server-mcpindex@latest"]
    }
  }
}

@latest поддерживает вас в актуальном состоянии: это рекомендательный сервер обнаружения (не внутрипутевой шлюз), поэтому он не имеет фиксированной версии — npx загружает новейшую версию при следующем перезапуске хоста, без ручного обновления.

Перезапустите Claude Desktop. Затем спросите:

«Найдите мне MCP-сервер, который может читать PDF и записывать содержимое в S3.»

Claude вызывает recommend_mcp_for_task и возвращает топ-3 серверов с командами установки.

Использование из Cursor

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "mcpindex": {
      "command": "npx",
      "args": ["-y", "mcp-server-mcpindex@latest"]
    }
  }
}

Использование из Cline

Добавьте в настройки Cline:

npx -y mcp-server-mcpindex@latest

Инструменты

Инструмент

Что делает

recommend_mcp_for_task

Передайте задачу на естественном языке. Возвращает топ-3 серверов с обоснованием, командами установки и оценками качества.

search_mcp_servers

Ключевое слово + семантический поиск по всему реестру. Необязательный фильтр по категориям.

get_install_command

Получите точный JSON/CLI для установки сервера и клиента (Claude Desktop, Claude Code, Cursor, Gemini CLI, Cline, Zed).

compare_servers

Сравнение 2–5 серверов бок о бок — оценки качества, пути установки, переменные окружения.

check_tool_trust

Предварительный рекомендательный вердикт для конкретного инструмента на сервере. Fail-CLOSED: возвращает UNVERIFIED, если вердикт отсутствует.

assess_server

Агрегированный предварительный вердикт по всем инструментам на сервере. Та же структура, что и check_tool_trust.

Интеграция с агентными фреймворками: предварительный рекомендательный экран

check_tool_trust — это интеграционная поверхность каталогового клиента (не внутрипутевой mcpindex-gate). Он позволяет агентным фреймворкам (Composio, Mastra, LangChain, DSPy, циклам прямых вызовов LLM-инструментов) запрашивать рекомендательный вердикт экрана перед отправкой вызова. В v1 вы увидите REVIEW или UNVERIFIED — это не допуск по безопасности.

Используете Mastra? Родственный пакет @mcp-index/mastra поставляет этот же экран в виде готового хука beforeToolCall — npm i @mcp-index/mastra, без дополнительной настройки.

Контракт вердикта (v1)

{
  "directive": "ALLOW" | "DENY" | "REVIEW" | "UNVERIFIED",
  "status":    "EVALUATED" | "PARTIAL" | "STALE" | "ERROR",
  "granularity": "description-level" | null,  // scope of a PARTIAL screen
  "dimensions": [
    { "id": "tool_safety", "verdict": "PASS", "severity": "INFO" }
  ],
  "expires_at": "2026-06-30T00:00:00Z",
  "honest_limits": [
    "conformance_monitored_not_enforced",
    "calibrated_false_v1",
    "advisory_deployment"
  ],
  "verdict_contract_version": "1.0.0",
  "server_id": "github",
  "tool_name": "create_pull_request",
  "source_url": "https://mcpindex.ai/api/v1/trust/tool/github/create_pull_request",
  "fetched_at": "2026-05-28T18:42:11.118Z"
}

Бесплатный вердикт включает директивы + измерения + свежесть. Цитаты доказательств, обоснование LLM и история цепочки — это платные поверхности и здесь намеренно опущены.

Честные ограничения (закрепите их в своём UI шлюза)

Каждый вердикт v1 поставляется с этими тремя оговорками, и ваш шлюз ДОЛЖЕН отображать их при каждом решении о отправке:

  1. conformance_monitored_not_enforced — издатели сами декларируют соответствие; mcpindex отслеживает расхождения, но не блокирует на сетевом уровне.

  2. calibrated_false_v1 — серьёзность измерений ещё не откалибрована по реальным данным об инцидентах.

  3. advisory_deployment — вердикт носит рекомендательный характер; агенту (или человеку, проверяющему агента) принадлежит окончательное решение.

Привязка к истории: история, привязанная к Bitcoin через OTS; финализация Bitcoin при N=6 подтверждениях (~1 час); ожидание ~10 минут. Точность под-окна заявлена, но не доказана.

Паттерн интеграции (в стиле LangChain, прямая конвенция вызова LLM-инструментов)

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const mcpindex = new Client({ name: 'gate', version: '1.0.0' }, { capabilities: {} });
await mcpindex.connect(new StdioClientTransport({
  command: 'npx', args: ['-y', 'mcp-server-mcpindex@latest'],
}));

// gateToolCall wraps any agent tool dispatch. Plug it in front of
// the LangChain / DSPy / Mastra / Composio tool-call hook.
async function gateToolCall({ serverId, toolName, invoke, askHuman }) {
  const res = await mcpindex.callTool({
    name: 'check_tool_trust',
    arguments: { server_id: serverId, tool_name: toolName },
  });
  const verdict = JSON.parse(res.content[0].text);

  // Pin the v1 caveats in the audit log no matter what.
  audit.log({ verdict, caveats: verdict.honest_limits });

  switch (verdict.directive) {
    case 'REVIEW':
      // Fail-CLOSED to human. Do NOT auto-execute on REVIEW.
      // At v1 this is the common screened outcome (semantic-only).
      return askHuman({ verdict, action: `${serverId}/${toolName}` });

    case 'UNVERIFIED':
      // No verdict on file (or upstream unreachable). Fail-CLOSED.
      // Recommend human review. Do NOT fail-open to invoke().
      return askHuman({
        verdict,
        action: `${serverId}/${toolName}`,
        note: 'No trust verdict on file. Human review required before first use.',
      });

    case 'ALLOW':
      // Reserved in the contract — not produced by the v1 public screen.
      // Keep the branch for future conformance-earned ALLOW; do not expect it today.
      return invoke();

    case 'DENY':
      // Reserved in the contract — not produced by the v1 public screen.
      throw new Error(
        `mcpindex denied ${serverId}/${toolName}: ${JSON.stringify(verdict.dimensions)}`,
      );

    default:
      // Unknown directive. Fail-CLOSED.
      return askHuman({ verdict, action: `${serverId}/${toolName}` });
  }
}

Ключевое правило: никогда не открывать отказ

Если конечная точка вердикта недоступна, возвращает 404, истекает по таймауту, возвращает некорректный JSON или для этого сервера ещё нет вердикта, check_tool_trust возвращает directive: "UNVERIFIED" + status: "ERROR". Он никогда не приводит молча к ALLOW. Ваш код шлюза ДОЛЖЕН рассматривать UNVERIFIED как «требуется проверка человеком», а не как «выглядит нормально, отправляем».

status — это телеметрия полноты экрана, отличная от решения о доверии directive: EVALUATED (полный экран), PARTIAL (только часть поверхности, например, на уровне описания — см. granularity), STALE (вердикт просрочен), ERROR (недоступен / нет вердикта). Частичный экран никогда не сообщается как EVALUATED.

Это протестировано. См. test/trust.test.mjs.

Использование библиотеки напрямую (без MCP)

Клиент доверия также экспортируется как обычный ES-модуль:

import { checkToolTrust, assessServer } from 'mcp-server-mcpindex/src/trust.mjs';

const verdict = await checkToolTrust({
  serverId: 'github',
  toolName: 'create_pull_request',
});

if (verdict.directive !== 'ALLOW') {
  // Hand to a human, log, or block.
}

Бэкенд

По умолчанию вызовы идут на https://mcpindex.ai. Переопределите с помощью MCPINDEX_API_BASE=..., если вы размещаете свой сервер.

Бесплатный тариф ограничен 60 запросами в минуту на IP. Платные ключи появятся для более высокой пропускной способности и полного вердикта с доказательствами (цитаты доказательств, обоснование LLM, история цепочки).

Связанные пакеты

Три способа интегрировать mcpindex в агента для разных поверхностей:

Пакет

Установка

Что делает

mcp-server-mcpindex (этот пакет)

npm i -g mcp-server-mcpindex

Каталог + рекомендательный экран в виде MCP-сервера: поиск серверов по задаче и check_tool_trust перед вызовом.

@mcp-index/mastra

npm i @mcp-index/mastra

Тот же рекомендательный экран, подключённый к Mastra как хук beforeToolCall (предупреждение / принуждение).

@mcp-index/sdk

npm i @mcp-index/sdk

Внутрипутевой шлюз расхождений: wrap() MCP-сессию и ПРИОСТАНОВИТЕ вызов, когда контракт инструмента отклоняется от вашего пина.

Рекомендательный экран против шлюза расхождений: этот пакет и @mcp-index/mastra спрашивают mcpindex «был ли этот инструмент проверен?» (сетевой вердикт). @mcp-index/sdk задаёт другой вопрос локально: «изменился ли контракт этого инструмента с момента его закрепления?» Они дополняют друг друга, и ни один не зависит от другого.

Лицензия

MIT.

Проект

Неофициально. Не связано с Anthropic.

Available Tools

6 tools
assess_serverA

Aggregated pre-flight trust assessment across all tools on an MCP server. Same verdict shape as check_tool_trust. Use for "is THIS server worth integrating?" decisions. v1 advisory; conformance monitored not enforced; verdicts may be UNVERIFIED if not yet probed.

ParametersJSON Schema
NameRequiredDescriptionDefault
server_idYesServer slug to assess.

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description discloses behavioral traits: advisory nature, conformance monitoring not enforced, and potential UNVERIFIED verdicts. This adds valuable context beyond a simple read operation, though no side effects or auth needs are mentioned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three concise sentences without redundancy: purpose, use, and behavioral notes. Front-loaded with the core action, efficient and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers purpose, usage guidance, verdict shape, and advisory nature. For a simple one-parameter tool with no output schema, it provides sufficient context, though explicit mention of return format would be slightly better.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter 'server_id' is described in the schema as 'Server slug to assess.' The description does not add new meaning beyond usage context. With 100% schema coverage, a baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool performs an aggregated pre-flight trust assessment across all tools on a server, using the specific verb 'assess' and resource 'server'. It distinguishes from sibling 'check_tool_trust' by noting aggregation, and clarifies the verdict shape is identical.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states the use case: 'is THIS server worth integrating?' decisions. It also provides context on when to be cautious with 'v1 advisory; conformance monitored not enforced; verdicts may be UNVERIFIED if not yet probed', guiding appropriate reliance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

check_tool_trustA

Pre-invocation advisory screen for a specific tool on an MCP server. Returns an advisory verdict object (directive ALLOW | DENY | REVIEW | UNVERIFIED, dimensions, freshness). At v1 the public screen produces REVIEW or UNVERIFIED only — ALLOW/DENY are reserved. Not the in-path gate (mcpindex-gate). Agents SHOULD treat UNVERIFIED as "human review required", never as ALLOW.

ParametersJSON Schema
NameRequiredDescriptionDefault
server_idYesServer slug (e.g. "github", "filesystem"). Same id used by search_mcp_servers.
tool_nameYesTool name as exposed by the server (e.g. "create_pull_request").

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It accurately describes behavior: returns advisory verdict with specific fields, v1 only produces REVIEW or UNVERIFIED. Does not mention side effects, but none expected. Could add authentication requirements, but sufficient for a read-only check.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, no fluff. Front-loads purpose, then constraints, then usage guideline. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple two-parameter tool with no output schema, the description covers purpose, return value, version limitations, and usage advice. No gaps for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% (both parameters described in schema). Description adds no extra meaning beyond what schema provides. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: a pre-invocation advisory screen for a specific tool. It uses specific verb 'check' and resource 'tool trust', and distinguishes from siblings like assess_server and search_mcp_servers by focusing on a single tool's trust level.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use (pre-invocation advisory) and when not (not the in-path gate). Provides clear directive: treat UNVERIFIED as human review required. Distinguishes from sibling tools effectively.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

compare_serversA

Side-by-side comparison of 2-5 MCP servers - quality scores, install paths, transport types, env vars.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugsYesServer slugs to compare.

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It discloses the output content (quality scores, install paths, etc.) but does not mention any side effects, auth requirements, or that it is a read-only operation. It assumes a non-destructive nature, but this is not explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence encapsulates the core functionality without any wasted words. It is front-loaded with the key action 'Side-by-side comparison' and details the compared attributes.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple one-parameter tool with no output schema, the description is relatively complete by listing the compared attributes. However, it does not mention output format, ordering, or whether results are aggregated, which would enhance completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% for the single parameter 'slugs', with min/max items already defined. The description does not add semantic detail beyond what the schema provides, so it meets the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool compares 2-5 MCP servers side-by-side, listing specific attributes (quality scores, install paths, etc.). This distinguishes it from siblings like assess_server (single server) and recommend_mcp_for_task (recommendation).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies use for comparing multiple servers but does not explicitly state when to use it versus alternatives or any prerequisites. It could benefit from guidance on when to choose compare_servers over assess_server or search_mcp_servers.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_install_commandA

Get the exact install command for a given MCP server and client. Returns a JSON block ready to paste into the client config.

ParametersJSON Schema
NameRequiredDescriptionDefault
clientYesTarget client.
server_slugYesSlug of the server (from search_mcp_servers or recommend_mcp_for_task results).

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Without annotations, the description discloses the tool returns a JSON command ready to paste. It does not mention any side effects or authentication, but for a retrieval tool this is sufficiently transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no wasted words, perfectly front-loaded with the action and output.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with two well-described parameters and no output schema, the description is complete: it explains what it does and what it returns.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and both parameters have descriptions. The description adds marginal value beyond the schema, so baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves the install command for a given server and client, and specifies the output format (JSON block). This distinguishes it from sibling tools like search or recommend.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the description, but there is no explicit guidance on when to use this tool versus alternatives, nor conditions to avoid usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

recommend_mcp_for_taskA

Recommend the best MCP servers for a natural-language task. Returns top 3 ranked picks with reasoning, install commands, and quality scores. Use this when the user asks for the right MCP server for a task they want to do.

ParametersJSON Schema
NameRequiredDescriptionDefault
taskYesNatural-language description of the task, e.g. "read PDFs and write to S3" or "search GitHub and open a PR".

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the output structure: 'Returns top 3 ranked picks with reasoning, install commands, and quality scores.' This is sufficient for a read-only recommendation tool. It could mention ranking criteria or data sources for greater transparency, but the current description is clear.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences: the first states purpose and output, the second gives usage guidance. It is front-loaded with key information and contains no superfluous words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema), the description adequately covers what the tool does and returns. It mentions the top 3 picks, reasoning, install commands, and quality scores. It could be enhanced by referencing sibling tools for alternative uses, but it is sufficiently complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with a description for the 'task' parameter. The tool description does not add additional examples or constraints beyond the schema's example. Thus, per the baseline, a score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Recommend the best MCP servers for a natural-language task.' It specifies the verb (recommend), resource (MCP servers), and context (natural-language task). This distinguishes it from sibling tools like search_mcp_servers (which lists servers) and assess_server (which evaluates a single server).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says when to use the tool: 'Use this when the user asks for the right MCP server for a task they want to do.' It lacks explicit when-not-to-use or alternatives, but the context is clear enough for most agents.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_mcp_serversA

Keyword + semantic search across the full MCP server registry. Use when the user knows what tool category they want but not which server.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax results (default 10, max 50).
queryYesSearch query.
categoryNoOptional category filter (e.g. database, browser, github, productivity).

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description bears full responsibility for behavioral disclosure. It only states the search capability, missing details on read-only nature, authentication, rate limits, or any side effects. Minimal transparency beyond basic function.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the action and purpose. Every word adds value. No redundancy or unnecessary details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple search tool with 3 parameters and no output schema, the description is adequate but has gaps. It does not explain result format, pagination, or search behavior beyond 'keyword + semantic'. Could be more complete given lack of annotations and output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description does not add meaning beyond the schema; it mentions keyword + semantic search but that is already implicit. No additional parameter guidance.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool performs keyword + semantic search across the MCP server registry, with a specific use case ('when the user knows what tool category they want but not which server'). This distinguishes it from sibling tools like assess_server or get_install_command.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit context for when to use the tool, but does not mention when not to use it or list alternatives. The guidance is clear and useful, but lacks exclusion criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv0.3.7
    • First observedassess_server
    • First observedcheck_tool_trust
    • First observedcompare_servers
    • First observedget_install_command
    • First observedrecommend_mcp_for_task
    • First observedsearch_mcp_servers

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation5/5

Each tool targets a clearly distinct purpose: search, recommend, compare, install, and two levels of trust assessment (server-level and tool-level). Even the trust tools are well-differentiated by scope.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern using snake_case: assess_server, check_tool_trust, compare_servers, get_install_command, recommend_mcp_for_task, search_mcp_servers.

Tool Count5/5

With 6 tools covering search, recommendation, comparison, installation, and trust, the number is well-scoped for a server registry/helper. No tools feel redundant or unnecessary.

Completeness4/5

The set covers the core workflow of finding, evaluating, and installing MCP servers. A minor gap is the lack of a tool to retrieve full metadata for a single server (e.g., description, version), but search and comparison partially fill that need.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers