Skip to main content
Glama
x51xxx

OSP Marketing Tools MCP Server

by x51xxx

OSP Marketing Tools for Node.js

Model Context Protocol Language License

A comprehensive suite of tools for technical marketing content creation, optimization, and product positioning based on Open Strategy Partners' proven methodologies. This is a TypeScript implementation of the MCP server for OSP Marketing Tools.

Why TypeScript Implementation?

This TypeScript/Node.js implementation offers significant advantages over the original Python version:

  • Simplified Installation: Fewer dependencies and more straightforward setup process

  • Cross-Platform Compatibility: Works seamlessly on Windows without the common Python dependency issues

  • Faster Performance: Node.js typically offers better performance for this type of server

  • Modern JavaScript Ecosystem: Leverages the robust npm package ecosystem

  • Easier Integration: Simpler to integrate with web applications and other JavaScript tools

  • Lower Resource Usage: Generally requires less memory and system resources

Perfect for those who want to use OSP Marketing Tools without dealing with Python dependencies, virtual environments, or compatibility issues.

Related MCP server: WithSeismic MCP

Features

1. OSP Product Value Map Generator

Generate structured OSP product value maps that effectively communicate your product's worth and positioning. This tool provides:

  • Strategic tagline creation and refinement

  • Position statements across market, technical, UX, and business dimensions

  • Persona development with roles, challenges, and needs

  • Value case documentation with clear benefits, challenges, and solutions

  • Feature categorization in a structured hierarchy

2. OSP Meta Information Generator

Create optimized metadata for web content with proper keyword placement and SEO-friendly structure. This tool delivers:

  • Article titles (H1) with strategic keyword placement

  • Meta titles optimized for search (50-60 characters)

  • Meta descriptions with compelling value propositions (155-160 characters)

  • SEO-friendly URL slugs

  • Search intent analysis and optimization

  • Mobile display considerations

3. OSP Content Editing Codes

Apply OSP's semantic editing codes for comprehensive content review. This system provides:

  • Scope and narrative structure analysis

  • Flow and readability enhancement

  • Style and phrasing optimization

  • Word choice and grammar verification

  • Technical accuracy validation

  • Inclusive language guidance

  • Constructive feedback with before/after examples

4. OSP Technical Writing Guide

Systematic approach to creating high-quality technical content with proper narrative structure and flow. The guide covers:

  • Narrative structure principles and logical progression

  • Flow optimization and content organization

  • Style guidelines for clarity and precision

  • Technical accuracy verification

  • Content-type specific guidance (tutorials, reference docs, API docs)

  • Accessibility and internationalization best practices

5. OSP On-Page SEO Guide

Comprehensive system for optimizing web content for search engines and user experience. This guide includes:

  • Meta content optimization strategies

  • Content depth enhancement techniques

  • Search intent alignment across different query types

  • Keyword research and integration protocols

  • Internal linking best practices

  • Structured data implementation

  • Content promotion strategies

Installation

Prerequisites

  • Node.js 18 or higher

  • npm or yarn

Setup

You can install and use this package in two ways:

  1. Install the package globally:

Add to your Claude Desktop configuration file (claude_desktop_config.json):

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

Setup from source codes

# 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

Add to your Claude Desktop configuration file (claude_desktop_config.json):

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

Note for Windows users: Make sure to replace path/to/osp-marketing-tools-mcp with the actual path to the osp-marketing-tools-mcp directory on your computer. For example, if you cloned the repository to C:\Users\YourName\Documents\osp-marketing-tools-mcp, the args line should look like this:

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

Also, remember to use double backslashes \\ instead of single backslashes \ in the path.

Usage

Running the server in stdio mode (for Claude Desktop, Cursor, etc.)

npm start

Running the server in HTTP/SSE mode

npm run start:sse

This will start a web server on port 3000 (configurable via PORT environment variable) that exposes the MCP API via Server-Sent Events (SSE).

Once the server is running in HTTP/SSE mode, you can access the web interface at http://localhost:3000/ which provides an interactive demo of the available tools.

Available Tools

  • health_check - Server health status and resource availability check

  • get_editing_codes - OSP Editing Codes documentation and usage protocol for semantic content review

  • get_writing_guide - OSP Writing Guide with principles for creating high-quality technical content

  • get_meta_guide - OSP Meta Information Generator for web content metadata optimization

  • get_value_map_positioning_guide - OSP Product Value Map Generator for effective product positioning

  • get_on_page_seo_guide - OSP On-Page SEO Guide for comprehensive content optimization

Available Prompts

  • edit-content - Review content using OSP editing codes for improved quality and clarity

  • generate-meta - Generate optimized metadata for web content with proper keyword placement

  • generate-value-map - Create a structured OSP value map for product positioning

  • apply-writing-guide - Apply OSP writing principles to create technical content

  • optimize-seo - Apply on-page SEO strategies to optimize content for search

Example Usage

Using with Claude or other LLM

To use the OSP editing codes to review content, simply send this prompt to Claude (after configuring the MCP server):

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.

For generating a product value map:

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

Using with Direct API Integration (SSE)

The server provides a JavaScript client example that demonstrates how to connect to the MCP server using Server-Sent Events (SSE). When you run the server in HTTP/SSE mode, you can access the demo at http://localhost:3000/.

Here's a simple example of how to connect to the SSE endpoint programmatically:

// 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();
}

Development

# Run in development mode (stdio)
npm run dev

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

Project Structure

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

Attribution

This software is based on the content creation and optimization methodologies developed by Open Strategy Partners. It implements their LLM-enabled marketing tools and professional content creation frameworks.

For more information and original resources, visit:

  1. The OSP Writing and Editing Guide

  2. Editing Codes Quickstart Guide

  3. OSP Free Resources

License

This software is licensed under the Attribution-ShareAlike 4.0 International license from 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. Dates show when Glama detected each change.

  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
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

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/x51xxx/osp-marketing-tools-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server