Skip to main content
Glama
x51xxx

OSP Marketing Tools MCP Server

by x51xxx

Herramientas de marketing de OSP para Node.js

Protocolo de contexto modeloIdiomaLicencia

Un conjunto completo de herramientas para la creación, optimización y posicionamiento de productos de contenido de marketing técnico, basado en las metodologías probadas de Open Strategy Partners . Se trata de una implementación en TypeScript del servidor MCP para las herramientas de marketing de OSP.

¿Por qué implementar TypeScript?

Esta implementación de TypeScript/Node.js ofrece ventajas significativas sobre la versión original de Python:

  • Instalación simplificada : menos dependencias y un proceso de configuración más sencillo

  • Compatibilidad entre plataformas : funciona perfectamente en Windows sin los problemas comunes de dependencia de Python

  • Rendimiento más rápido : Node.js generalmente ofrece un mejor rendimiento para este tipo de servidor

  • Ecosistema de JavaScript moderno : aprovecha el sólido ecosistema de paquetes npm

  • Integración más sencilla : más sencilla de integrar con aplicaciones web y otras herramientas de JavaScript

  • Menor uso de recursos : generalmente requiere menos memoria y recursos del sistema.

Perfecto para aquellos que desean utilizar las herramientas de marketing de OSP sin tener que lidiar con dependencias de Python, entornos virtuales o problemas de compatibilidad.

Related MCP server: WithSeismic MCP

Características

1. Generador de mapas de valor del producto OSP

Genere mapas de valor de producto OSP estructurados que comuniquen eficazmente el valor y el posicionamiento de su producto. Esta herramienta proporciona:

  • Creación y perfeccionamiento de eslóganes estratégicos

  • Declaraciones de posición en las dimensiones de mercado, técnicas, de experiencia de usuario y comerciales

  • Desarrollo de personajes con roles, desafíos y necesidades

  • Documentación de casos de valor con beneficios, desafíos y soluciones claros

  • Categorización de características en una jerarquía estructurada

2. Generador de metainformación OSP

Cree metadatos optimizados para contenido web con una correcta ubicación de palabras clave y una estructura optimizada para SEO. Esta herramienta ofrece:

  • Títulos de artículos (H1) con ubicación estratégica de palabras clave

  • Metatítulos optimizados para la búsqueda (50-60 caracteres)

  • Meta descripciones con propuestas de valor convincentes (155-160 caracteres)

  • Slugs de URL optimizados para SEO

  • Análisis y optimización de la intención de búsqueda

  • Consideraciones sobre la visualización en dispositivos móviles

3. Códigos de edición de contenido OSP

Aplique los códigos de edición semántica de OSP para una revisión exhaustiva del contenido. Este sistema proporciona:

  • Análisis del alcance y la estructura narrativa

  • Mejora del flujo y la legibilidad

  • Optimización de estilo y fraseo

  • Elección de palabras y verificación gramatical

  • Validación de la precisión técnica

  • Orientación lingüística inclusiva

  • Comentarios constructivos con ejemplos de antes y después

4. Guía de redacción técnica de OSP

Enfoque sistemático para la creación de contenido técnico de alta calidad con una estructura narrativa y fluidez adecuadas. La guía abarca:

  • Principios de estructura narrativa y progresión lógica

  • Optimización del flujo y organización del contenido

  • Pautas de estilo para mayor claridad y precisión

  • Verificación de la precisión técnica

  • Orientación específica según el tipo de contenido (tutoriales, documentos de referencia, documentos de API)

  • Mejores prácticas de accesibilidad e internacionalización

5. Guía de SEO en la página de OSP

Sistema integral para optimizar el contenido web para motores de búsqueda y la experiencia del usuario. Esta guía incluye:

  • Estrategias de optimización de metacontenido

  • Técnicas de mejora de la profundidad del contenido

  • Alineación de la intención de búsqueda en diferentes tipos de consultas

  • Protocolos de investigación e integración de palabras clave

  • Mejores prácticas de enlaces internos

  • Implementación de datos estructurados

  • Estrategias de promoción de contenidos

Instalación

Prerrequisitos

  • Node.js 18 o superior

  • npm o hilo

Configuración

Puede instalar y utilizar este paquete de dos maneras:

Configuración a través de npm (recomendado)

  1. Instalar el paquete globalmente:

Agregue a su archivo de configuración de Claude Desktop ( claude_desktop_config.json ):

{
  "mcpServers": {
    "ai_think_gate": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/osp-marketing-tools-mcp"
      ]
    }
  }
}

Configuración a partir de códigos fuente

# Clone the repository
git clone https://github.com/x51xxx/osp-marketing-tools-mcp.git
cd osp-marketing-tools-mcp

# Install dependencies
npm install

# Build the project
npm run build

Agregue a su archivo de configuración de Claude Desktop ( claude_desktop_config.json ):

{
  "mcpServers": {
    "osp_marketing_tools": {
      "command": "node",
      "args": [
        "path/to/osp-marketing-tools-mcp/dist/index.js"
      ]
    }
  }
}

Nota para usuarios de Windows: Asegúrese de reemplazar path/to/osp-marketing-tools-mcp con la ruta real al directorio ` osp-marketing-tools-mcp en su computadora. Por ejemplo, si clonó el repositorio en C:\Users\YourName\Documents\osp-marketing-tools-mcp , la línea args debería verse así:

"args": ["C:\\Users\\YourName\\Documents\\osp-marketing-tools-mcp\\dist\\index.js"]

Además, recuerde utilizar barras invertidas dobles \\ en lugar de barras invertidas simples \ en la ruta.

Uso

Ejecutar el servidor en modo stdio (para Claude Desktop, Cursor, etc.)

npm start

Ejecutar el servidor en modo HTTP/SSE

npm run start:sse

Esto iniciará un servidor web en el puerto 3000 (configurable a través de la variable de entorno PORT) que expone la API de MCP a través de eventos enviados por el servidor (SSE).

Una vez que el servidor esté funcionando en modo HTTP/SSE, puede acceder a la interfaz web en http://localhost:3000/ que proporciona una demostración interactiva de las herramientas disponibles.

Herramientas disponibles

  • health_check - Comprobación del estado de salud del servidor y la disponibilidad de recursos

  • get_editing_codes - Documentación de códigos de edición de OSP y protocolo de uso para la revisión de contenido semántico

  • get_writing_guide - Guía de escritura OSP con principios para crear contenido técnico de alta calidad

  • get_meta_guide - Generador de metainformación OSP para la optimización de metadatos de contenido web

  • get_value_map_positioning_guide - Generador de mapas de valor de productos OSP para un posicionamiento eficaz del producto

  • get_on_page_seo_guide - Guía SEO On-Page de OSP para una optimización integral del contenido

Indicaciones disponibles

  • edit-content : revise el contenido utilizando códigos de edición OSP para mejorar la calidad y la claridad

  • generate-meta - Genera metadatos optimizados para contenido web con la ubicación adecuada de palabras clave

  • generate-value-map - Crear un mapa de valor OSP estructurado para el posicionamiento del producto

  • apply-writing-guide : aplique los principios de redacción de OSP para crear contenido técnico.

  • optimize-seo - Aplicar estrategias de SEO en la página para optimizar el contenido para la búsqueda

Ejemplo de uso

Uso con Claude u otro LLM

Para utilizar los códigos de edición de OSP para revisar el contenido, simplemente envíe este mensaje a Claude (después de configurar el servidor MCP):

Review this technical content using OSP editing codes:

Kubernetes is a container orchestration platform. It handles deploying applications and scaling them as needed. There's lots of things it can do. It's really good. You should use it for your applications to make them more resilient.

Para generar un mapa de valor del producto:

Generate an OSP value map for [Product Name] focusing on [target audience] with the following key features: [list features]

Example:
Generate an OSP value map for CloudDeploy focusing on DevOps engineers with these key features:
- Automated deployment pipeline
- Infrastructure as code support
- Real-time monitoring
- Multi-cloud compatibility

Uso con integración directa de API (SSE)

El servidor proporciona un ejemplo de cliente JavaScript que muestra cómo conectarse al servidor MCP mediante eventos enviados por el servidor (SSE). Al ejecutar el servidor en modo HTTP/SSE, puede acceder a la demostración en http://localhost:3000/ .

A continuación se muestra un ejemplo sencillo de cómo conectarse al punto final de SSE mediante programación:

// Connect to SSE endpoint
const source = new EventSource('http://localhost:3000/sse');
let sessionId;

// Listen for session ID
source.addEventListener('sessionId', (event) => {
    sessionId = JSON.parse(event.data).sessionId;
    console.log(`Connected with session ID: ${sessionId}`);
});

// Listen for tool responses
source.addEventListener('toolResponse', (event) => {
    const response = JSON.parse(event.data);
    console.log('Tool response:', response);
});

// Call a tool
async function callTool(name, args = {}) {
    const response = await fetch(`http://localhost:3000/messages?sessionId=${sessionId}`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            jsonrpc: '2.0',
            id: Date.now().toString(),
            method: 'tools/call',
            params: {
                name: name,
                arguments: args
            }
        })
    });

    return response.json();
}

Desarrollo

# Run in development mode (stdio)
npm run dev

# Run in development mode (HTTP/SSE)
npm run dev:sse

Estructura del proyecto

osp-marketing-tools-mcp/
├── prompts/             # Markdown resources from OSP tools
├── public/              # Static web files for HTTP server
│   └── index.html       # SSE client demo interface
├── src/
│   ├── utils/           # Utility functions
│   │   └── contentReader.ts
│   ├── tools/           # MCP tool implementations
│   │   └── index.ts
│   ├── prompts/         # MCP prompt templates
│   │   └── index.ts
│   ├── resources/       # MCP resource implementations
│   │   └── index.ts
│   ├── index.ts         # Main entry point (stdio)
│   └── http.ts          # HTTP/SSE server
├── dist/                # Compiled JavaScript (generated)
├── package.json
└── tsconfig.json

Atribución

Este software se basa en las metodologías de creación y optimización de contenido desarrolladas por Open Strategy Partners . Implementa sus herramientas de marketing basadas en LLM y sus marcos profesionales de creación de contenido.

Para obtener más información y recursos originales, visita:

  1. La guía de redacción y edición de OSP

  2. Guía de inicio rápido para la edición de códigos

  3. Recursos gratuitos de OSP

Licencia

Este software está licenciado bajo la licencia Attribution-ShareAlike 4.0 International de Creative Commons Corporation ("Creative Commons").

Available Tools

6 tools
get_editing_codesB

Get the Open Strategy Partners (OSP) editing codes documentation and usage protocol for editing texts. These semantic editing marks provide a standardized framework for content review with a teaching/learning focus.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/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 describes what the tool returns (documentation and usage protocol) but doesn't cover important aspects like whether it's a read-only operation, potential rate limits, authentication requirements, or error handling. For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.

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

Conciseness4/5

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

The description is appropriately concise with two sentences that efficiently convey the tool's purpose and the nature of the content. It's front-loaded with the main action and resource, though it could be slightly more structured by explicitly separating purpose from content characteristics.

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?

Given the tool has no parameters and no output schema, the description provides adequate basic information about what the tool does. However, it lacks details about the return format (e.g., whether it's structured data, a document, or a reference), which would be helpful since there's no output schema. For a simple retrieval tool, this is minimally viable but could be more complete.

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

Parameters4/5

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

The tool has zero parameters with 100% schema description coverage, so the baseline is 4. The description appropriately doesn't discuss parameters since none exist, which is efficient and correct for this case.

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: retrieving OSP editing codes documentation and usage protocol for editing texts. It specifies the resource (OSP editing codes) and the action (get), though it doesn't explicitly differentiate from sibling tools like 'get_writing_guide' or 'get_meta_guide' beyond mentioning the specific content type.

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. It mentions the tool's content focus (semantic editing marks for content review with teaching/learning focus) but doesn't indicate when to choose it over sibling tools like 'get_writing_guide' or 'get_on_page_seo_guide', nor does it specify any prerequisites or exclusions.

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

get_meta_guideC

Get the Open Strategy Partners (OSP) Web Content Meta Information Generation System for creating optimized article titles, meta titles, meta descriptions, and slugs for web content with proper keyword placement and search intent analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

C2.7/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It describes what the system does (generates optimized content elements) but lacks details on behavioral traits such as whether this is a read-only operation, if it requires authentication, rate limits, or what the output format looks like. This is a significant gap for a tool with zero annotation coverage.

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

Conciseness3/5

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

The description is a single run-on sentence that packs multiple concepts (system name, purpose, elements generated, and analysis features). While it conveys key information, it could be more structured and front-loaded for clarity. It's not overly verbose but could be tightened for better readability.

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 implied by generating optimized content with search intent analysis, and with no annotations or output schema, the description is incomplete. It doesn't explain what the tool returns (e.g., a guide, template, or generated text), how to interpret results, or any operational constraints, leaving gaps for effective agent use.

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

Parameters4/5

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

The input schema has 0 parameters with 100% coverage, so no parameter documentation is needed. The description appropriately doesn't discuss parameters, which is efficient. However, it could have mentioned if any implicit inputs or context are required, but this is minor, warranting a high score.

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

Purpose3/5

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

The description states the tool retrieves a specific system (OSP Web Content Meta Information Generation System) for creating optimized web content elements, which is a clear purpose. However, it doesn't distinguish this from sibling tools like 'get_on_page_seo_guide' or 'get_writing_guide' that might cover overlapping SEO/content optimization areas, making it somewhat vague about its unique scope.

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 implies usage for generating article titles, meta titles, descriptions, and slugs with keyword placement and search intent analysis, but provides no explicit guidance on when to use this tool versus alternatives like 'get_on_page_seo_guide' or 'get_writing_guide'. There are no exclusions or prerequisites mentioned, leaving usage context unclear.

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

get_on_page_seo_guideB

Get the Open Strategy Partners (OSP) On-Page SEO Optimization Guide for comprehensive web content optimization, covering meta content, keyword research, content depth, search intent alignment, internal linking, and structured data.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It states this is a 'Get' operation which implies read-only behavior, but doesn't explicitly confirm this or mention any other behavioral traits like authentication requirements, rate limits, response format, or potential side effects. For a 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.

Conciseness4/5

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

The description is a single, well-structured sentence that efficiently conveys the tool's purpose and scope. It front-loads the core function ('Get the Open Strategy Partners (OSP) On-Page SEO Optimization Guide') and then provides useful detail about what the guide covers. Every part of the sentence adds value without redundancy.

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 zero-parameter tool with no output schema and no annotations, the description provides adequate but minimal information. It tells what resource is retrieved and what topics it covers, but doesn't describe the return format, potential errors, or any operational constraints. Given the simplicity of the tool (no parameters), the description meets minimum viable standards but could be more complete regarding behavioral expectations.

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

Parameters4/5

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

The tool has zero parameters (input schema is empty object), so there are no parameters to document. The description appropriately doesn't discuss parameters since none exist. With 100% schema description coverage and zero parameters, a baseline of 4 is appropriate as the description doesn't need to compensate for any parameter documentation gaps.

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: 'Get the Open Strategy Partners (OSP) On-Page SEO Optimization Guide' with specific details about what the guide covers (meta content, keyword research, etc.). It uses a specific verb ('Get') and identifies the resource (OSP guide). However, it doesn't explicitly differentiate from sibling tools like 'get_meta_guide' or 'get_writing_guide' beyond mentioning SEO focus.

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. It doesn't mention when this SEO guide would be preferred over the 'get_meta_guide' or 'get_writing_guide' siblings, nor does it specify any prerequisites or contextual triggers for its use. The description simply states what the tool provides without usage context.

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

get_value_map_positioning_guideB

Get the Open Strategy Partners (OSP) Product Communications Value Map Generation System for Product Positioning, including taglines, position statements, personas, value cases, and feature categorization in a structured hierarchy.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It implies a read-only operation ('Get') but doesn't specify whether it requires authentication, has rate limits, returns structured vs. unstructured data, or handles errors. For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.

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

Conciseness4/5

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

The description is a single, well-structured sentence that efficiently lists the tool's purpose and key components without redundancy. It is appropriately sized for a no-parameter tool, though it could be slightly more front-loaded by starting with the core action ('Get the OSP Product Communications Value Map Generation System').

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?

Given the tool's complexity (retrieving a structured system with multiple components), no annotations, and no output schema, the description is moderately complete. It specifies what content is included but lacks details on return format, data structure, or behavioral traits, which are needed for full contextual understanding.

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

Parameters4/5

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

The tool has zero parameters, and schema description coverage is 100% (as there are no parameters to describe). The description doesn't need to add parameter semantics, so a baseline score of 4 is appropriate, as it efficiently avoids unnecessary detail while matching the schema's completeness.

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: retrieving a specific system (OSP Product Communications Value Map Generation System) with detailed content components (taglines, position statements, personas, value cases, feature categorization). It uses a specific verb ('Get') and identifies the resource, though it doesn't explicitly differentiate from sibling tools like 'get_meta_guide' or 'get_writing_guide' beyond naming the specific system.

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?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites, appropriate contexts, or exclusions, nor does it reference sibling tools like 'get_meta_guide' or 'get_writing_guide' to help the agent choose between them.

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

get_writing_guideB

Get the Open Strategy Partners (OSP) writing guide and usage protocol for creating high-quality technical content. This guide provides systematic principles for narrative structure, flow, style, and technical accuracy.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/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 describes what the tool returns ('writing guide and usage protocol'), but does not disclose any behavioral traits such as authentication requirements, rate limits, response format, or potential side effects. For a tool with zero annotation coverage, this is a significant gap in transparency.

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 appropriately sized and front-loaded. The first sentence clearly states the tool's purpose, and the second sentence adds useful context about the guide's content. Every sentence earns its place with no redundant or vague language, making it efficient and well-structured.

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?

Given the tool's complexity (simple retrieval with no parameters) and the lack of annotations and output schema, the description is minimally adequate. It explains what the tool does but does not provide enough context for full understanding, such as response format or behavioral details. Without an output schema, the description should ideally hint at return values, but it does not, leaving some gaps.

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

Parameters4/5

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

The tool has 0 parameters, and the input schema has 100% description coverage (though empty). With no parameters, the baseline score is 4, as there is nothing for the description to compensate for. The description does not need to add parameter semantics, so it meets expectations without extra effort.

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: 'Get the Open Strategy Partners (OSP) writing guide and usage protocol for creating high-quality technical content.' It specifies the verb ('Get') and resource ('writing guide and usage protocol'), and mentions the content's scope ('systematic principles for narrative structure, flow, style, and technical accuracy'). However, it does not explicitly differentiate this tool from its siblings (e.g., get_editing_codes, get_meta_guide), which would be needed for a score of 5.

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 its siblings. It mentions the guide's purpose ('for creating high-quality technical content'), but does not specify scenarios, prerequisites, or alternatives. For example, it does not clarify when to choose this over get_editing_codes or get_meta_guide, leaving usage context implied rather than explicit.

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

health_checkB

Check if the server is running and can access its resources

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

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

With no annotations provided, the description carries full burden for behavioral disclosure. It mentions checking server status and resource accessibility, but doesn't specify what constitutes 'running' or 'resources', whether this is a lightweight ping or intensive diagnostic, what authentication might be needed, or what the output format looks like. For a tool with zero annotation coverage, this leaves significant behavioral gaps.

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 communicates the core purpose without any wasted words. It's appropriately sized for a simple health check tool and front-loads the essential information ('Check if the server is running').

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?

Given the tool's simplicity (no parameters, no output schema, no annotations), the description provides adequate basic context about what the tool does. However, it lacks details about behavioral aspects (what 'check' entails, response format, error conditions) that would be helpful for an agent to understand the tool's operation fully, especially with no annotations to supplement.

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

Parameters4/5

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

The tool has zero parameters, and schema description coverage is 100% (empty schema is fully described as having no parameters). The description appropriately doesn't discuss parameters since none exist, which meets expectations for this dimension. A perfect score would require the description to explicitly note the lack of parameters, but it's reasonable to assume this from context.

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 with specific verbs ('check if...is running and can access') and resources ('server', 'its resources'), making it immediately understandable. However, it doesn't distinguish this health check tool from its siblings (all content/guide retrieval tools), which would require explicit differentiation for a perfect score.

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 or in what context it should be invoked. There are no prerequisites mentioned, no exclusions, and no reference to sibling tools, leaving the agent with no usage framework beyond the basic purpose statement.

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 updates
    • First observedget_editing_codes
    • First observedget_meta_guide
    • First observedget_on_page_seo_guide
    • First observedget_value_map_positioning_guide
    • First observedget_writing_guide
    • First observedhealth_check

TDQS

B3.3/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: editing codes, meta guide, SEO guide, value map positioning, writing guide, and health check. The descriptions specify unique domains (e.g., semantic editing marks vs. web content optimization), making misselection unlikely.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with 'get_' prefix for five tools and a descriptive 'health_check' for the sixth. The naming is uniform and predictable, using snake_case throughout without deviations.

Tool Count4/5

Six tools are reasonable for a marketing-focused server, covering key areas like SEO, content creation, and positioning. It's slightly thin but well-scoped; each tool earns its place without redundancy or obvious gaps in the core domain.

Completeness3/5

The tools provide comprehensive guides for content creation, SEO, and positioning, but they are all 'get' operations with no create/update/delete actions. This limits agent workflows to retrieval only, leaving notable gaps for interactive or generative tasks in the marketing domain.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers