Skip to main content
Glama
Tar-ive

Grants Search MCP Server

by Tar-ive

Búsqueda de subvenciones del servidor MCP

Este proyecto es un servidor MCP (Protocolo de Contexto Modelo) que proporciona una herramienta para buscar subvenciones gubernamentales basadas en palabras clave.

Introducción en vídeo

Introducción en vídeo

Descripción general

El servidor MCP de búsqueda de subvenciones se crea con el paquete @modelcontextprotocol/sdk . Ofrece una herramienta única llamada "search-grants" que permite a los usuarios buscar subvenciones gubernamentales disponibles mediante una consulta.

El servidor interactúa con la API de subvenciones más simples para obtener los datos de la subvención y formatea los resultados para su visualización.

El MCP obtiene datos de la API de Subvenciones Simpler , que proporciona un conjunto completo de puntos de acceso para acceder a información sobre subvenciones gubernamentales. Esta API se encuentra actualmente en su versión alfa, diseñada principalmente para pruebas y retroalimentación. Incluye funciones como la búsqueda de oportunidades, la recuperación de información de agencias y el acceso a datos detallados de subvenciones, todo ello estructurado en un formato intuitivo.

La API admite varios filtros para buscar subvenciones, como agencia, tipo de solicitante, categoría de financiación y más. También ofrece opciones de paginación para gestionar grandes conjuntos de resultados eficazmente.

Related MCP server: Startup Concierge Go MCP Server

Características

  • Búsqueda de subvenciones gubernamentales por palabra clave

  • Paginar los resultados de la búsqueda

  • Muestra información detallada sobre cada subvención, incluyendo:

    • Título, número y estado de la oportunidad

    • Información de financiación (nivel mínimo de adjudicación, límite máximo de adjudicación, categoría)

    • Fechas y plazos

    • Información del contacto

    • Requisitos de elegibilidad

    • URL de información adicional

Configuración

  1. Clone el repositorio y navegue hasta el directorio del proyecto.

  2. Instale las dependencias necesarias:

    • Node.js 16 o superior

    • npm install

  3. Establezca la variable de entorno API_KEY con su clave API de Simpler Grants.

  4. Inicie el servidor MCP:

    npm start

El servidor comenzará a funcionar y escuchará las conexiones entrantes del cliente MCP.

Uso

Una vez que el servidor esté en funcionamiento, puedes conectarte a él mediante un cliente MCP (por ejemplo, Claude Desktop).

Para utilizar la herramienta "search-grants", simplemente envíe una solicitud con los siguientes parámetros:

  • query : La consulta de búsqueda (por ejemplo, "Inteligencia artificial", "Cambio climático")

  • page : El número de página para la paginación (predeterminado: 1)

  • grantsPerPage : la cantidad de subvenciones que se mostrarán por página (predeterminado: 3)

El servidor responderá con un resumen formateado de los resultados de la búsqueda, incluidos los detalles de la concesión.

Personalización

Puede personalizar el servidor modificando lo siguiente:

  • formatGrantDetails : La función que formatea la información de la concesión para su visualización

  • createSummary : La función que genera el resumen de los resultados de la búsqueda

  • API_KEY : La clave API de Simpler Grants utilizada para autenticar las solicitudes

Solución de problemas

Si tiene algún problema, consulte los registros del servidor para obtener más información. También puede contactar con los responsables del proyecto para obtener ayuda.

Contribuyendo

Si desea contribuir a este proyecto, bifurque el repositorio y envíe una solicitud de extracción con sus cambios.

Available Tools

1 tool
search-grantsC

Search for government grants based on keywords

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesSearch query for grants (e.g., 'Artificial intelligence', 'Climate change')
pageNoPage number for pagination (default: 1)
grantsPerPageNoNumber of grants per page (default: 3)

TDQS

C2.9/5.0
Behavior2/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 of behavioral disclosure. It mentions searching but doesn't describe behavioral traits such as rate limits, authentication needs, response format, error handling, or whether it's read-only or has side effects. For a search tool with zero annotation coverage, this leaves significant gaps in understanding how it behaves.

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 a single, efficient sentence that directly states the tool's function without unnecessary words. It is appropriately sized and front-loaded, making it easy to understand quickly. Every part of the sentence contributes to clarifying the purpose.

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

Completeness2/5

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

Given the complexity of a search tool with no annotations and no output schema, the description is incomplete. It lacks information on behavioral aspects, usage context, and what to expect in return. While the schema covers parameters well, the overall context for effective tool use is insufficient, especially for an agent needing to understand results and limitations.

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 description adds minimal semantic context beyond the input schema, which has 100% coverage with clear descriptions for all parameters. It implies keyword-based searching but doesn't provide additional details like search scope, result types, or parameter interactions. With high schema coverage, the baseline is 3, as the schema does most of the work.

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

Purpose4/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 as 'Search for government grants based on keywords', which includes a specific verb ('Search'), resource ('government grants'), and mechanism ('based on keywords'). It distinguishes the tool's function well, though without sibling tools, differentiation isn't applicable. The purpose is specific and actionable.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives, prerequisites, or limitations. It simply states what the tool does without context about appropriate scenarios or constraints. Since there are no sibling tools, this is less critical, but general usage context is still missing.

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. 1 tool update
    • First observedsearch-grants

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'search-grants' has a clear, distinct purpose that cannot be confused with any other tool in the set.

Naming Consistency5/5

The single tool name 'search-grants' follows a consistent verb-noun pattern, and with only one tool, there is no inconsistency or deviation to evaluate. The naming is straightforward and predictable.

Tool Count2/5

A single tool for a grants search server feels thin and under-scoped. While search is a core function, typical grant-related workflows might include operations like filtering, sorting, or retrieving details, making one tool insufficient for comprehensive coverage.

Completeness2/5

The tool set is severely incomplete for a grants search domain. It only provides a basic search function, with obvious gaps such as no ability to view grant details, filter by criteria, or manage saved searches, which are essential for effective agent interaction.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers