Semantic Pen

Provides an MCP server for generating SEO-optimized AI articles and managing content workflows via Semantic Pen.

javascript

2

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pushkarsingh32-semantic-pen-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "semantic-pen-mcp-server@latest"
      ],
      "env": {
        "SEMANTIC_PEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

You can run the Semantic Pen MCP Server to automate AI article generation and SEO content workflows directly from your MCP client. This server exposes actionable endpoints for creating, organizing, and retrieving optimized articles, making it easy to integrate AI writing into your content process.

How to use

You connect to the Semantic Pen MCP Server from your MCP client, then use the available endpoints to browse projects, generate new articles, and fetch finished content. The server is designed to work with your existing AI writing setup, letting you trigger article creation with topics and keywords and retrieve full HTML ready for publishing. Start by adding the server configuration to your MCP client, then call the provided actions to manage projects and articles.

How to install

Prerequisites: you need Node.js 18+ installed on your machine. You will run a local MCP server configuration via your MCP client. Below are concrete steps to enable the server using the official one-shot setup shown in the configuration examples.

{
  "mcpServers": {
    "semantic-pen": {
      "command": "npx",
      "args": ["-y", "semantic-pen-mcp-server@latest"],
      "env": {
        "SEMANTIC_PEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuration and usage notes

Configure your MCP client with the provided stdio server entry to enable on-demand article generation. Replace your-api-key-here with your actual API key from Semantic Pen to enable authenticated access.

If you prefer to set this up in different environments, you can reuse the same configuration in multiple clients, ensuring each one has the SEMANTIC_PEN_API_KEY variable set in its environment block.

Examples of available actions

Use the server to manage content projects and articles. The main actions include listing projects, listing a project’s articles, searching projects by name, creating new AI-generated articles, and retrieving a specific article by ID.

{
  "mcpServers": {
    "semantic-pen": {
      "command": "npx",
      "args": ["-y", "semantic-pen-mcp-server@latest"],
      "env": {
        "SEMANTIC_PEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Troubleshooting

Ensure your SEMANTIC_PEN_API_KEY is correctly set in the environment. If the API key verification fails, confirm the key is valid and has active credits. If the server does not start, verify you are running Node.js 18+ and that the MCP client can access the server URL or start the local stdio process without errors.

Security and access notes

Keep your API key confidential and rotate it if you suspect exposure. Only expose the API key to trusted MCP clients and environments. Use standard security practices to protect your environment variables and avoid committing keys to version control.

Available tools

The server provides endpoints to manage content projects and articles.

Available tools

get_projects

Retrieve all content projects from the article queue. No parameters required.

get_project_articles

Fetch all articles belonging to a specific project. Requires projectId (string) as input.

search_projects

Search for projects by name with partial matching. Requires projectName (string) as input.

create_article

Generate a SEO-optimized AI article with customizable options such as topic, keyword, word count, language, article type, and tone.

get_article

Get a specific article by its ID and retrieve the full content.