OSP Marketing Tools

You can run a TypeScript MCP server that exposes OSP Marketing Tools for model-driven content creation, metadata generation, editing guidance, and on-page optimization. This server is designed for easy installation, cross‑platform use, and seamless integration with JavaScript tooling, making it practical to plug into your content workflows and CLIs.

How to use

Connect to the MCP server from your client and call the available tools by name. You will receive structured responses that guide your content improvements, generate metadata, and help you position your product across market, technical, UX, and business dimensions. Use the Server‑Sent Events (SSE) or standard request/response flow to invoke tools like health checks, editing codes, and writing guides, and then apply the results directly to your content or workflows.

How to install

Prerequisites
- Node.js 18 or higher
- npm or yarn

Setup via npm (recommended)

1. Install the MCP package globally via npx:
`

How to install

Follow one of the two installation paths below. Use the path that fits your environment and preference.

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

How to install

# Option 1: Install via CLI config (recommended)
# Add the MCP server entry to your client configuration:
# (exact file path depends on your setup)

How to install

# Option 2: Build from source and run locally
# 1. Clone the repository
# 2. Install dependencies
# 3. Build the project
# 4. Run the local server

How to install

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

How to install

Two concrete workflows are shown here. The first uses a quick, globally accessible MCP runner via npx. The second builds and runs a local copy from source to expose the MCP server at your chosen runtime path. Follow the exact command blocks to start the server in your environment.

How to install

Running the server in stdio mode and then using an MCP client is supported. You can start the server with the appropriate command and then connect your client to the local process.

How to use

Once the server is running, you can use the following tools to improve content quality, structure, and SEO readiness. Use a client to request a tool by name and pass the required arguments. The server responds with actionable results you can apply directly.

Additional configuration and notes

• The server runs with Node.js and exposes an interface that your content tools can call via MCP endpoints. - You may run in an HTTP/SSE mode for browser-based demos, or in stdio mode for local CLI integration. - Ensure you have a compatible Node.js version and npm or yarn installed. - If you need a local development setup, build from source and start the local runtime as shown in the installation steps.

Troubleshooting

If you encounter connection issues, verify that the server process is running, confirm the configured command and path, and check that your client points to the correct runtime (local stdio or HTTP/SSE). Review any port or path configurations if you customize the startup. Ensure dependencies are installed and that the build step completed successfully.

Examples and workflows

To use the client, configure your MCP connection, start the server, and issue tool calls by name such as health_check, get_editing_codes, get_writing_guide, get_meta_guide, get_value_map_positioning_guide, and get_on_page_seo_guide. The results will guide content edits, metadata generation, and SEO optimization across your materials.

Available tools

health_check

Checks server health status and resource availability to ensure the MCP backend is ready for tool calls.

get_editing_codes

Provides semantic editing codes for review, including scope, narrative structure, flow, style, grammar, and accessibility guidance.

get_writing_guide

Offers a structured writing guide with principles for clear, precise technical content and best practices for different content types.

get_meta_guide

Generates optimized metadata for web content, including titles, descriptions, slugs, and SEO considerations.

get_value_map_positioning_guide

Produces structured product value maps with positioning, personas, benefits, challenges, and feature categorization.

get_on_page_seo_guide

Provides on‑page SEO guidance covering keyword usage, content depth, internal linking, and structured data.