semantic-pen-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@semantic-pen-mcp-server create an article on sustainable living"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Semantic Pen MCP Server
A one-click MCP server for Semantic Pen that allows you to create, view, and manage articles and projects directly from Claude Code and Cursor.
Quick Setup (Recommended)
Just add this to your MCP configuration - no installation required!
For Claude Code
Add to your ~/.config/claude-code/settings.json:
{
"mcpServers": {
"semantic-pen": {
"command": "npx",
"args": ["-y", "@semanticpen/mcp-server@latest"],
"env": {
"SEMANTIC_PEN_API_KEY": "your-api-key-here"
}
}
}
}For Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"semantic-pen": {
"command": "npx",
"args": ["-y", "@semanticpen/mcp-server@latest"],
"env": {
"SEMANTIC_PEN_API_KEY": "your-api-key-here"
}
}
}
}Replace your-api-key-here with your actual Semantic Pen API key.
Related MCP server: Kilonova MCP
Features
🔑 Automatic API Key Verification - Verifies your API key on startup
📋 Project Management - View all your projects from article queue
📚 Article Management - View articles within specific projects
🔍 Project Search - Search projects by name
✍️ Article Creation - Create new articles with customizable settings
📄 Article Retrieval - Get specific article content and metadata with full HTML
Available Tools
get_projects
Get all your projects from the article queue
No parameters requiredget_project_articles
Get all articles from a specific project
projectId (string): The project ID to get articles fromsearch_projects
Search projects by name
projectName (string): The project name to search for (partial match)create_article
Create a new article
targetArticleTopic (string): The topic/title for the article
targetKeyword (string, optional): Target SEO keyword
wordCount (number, optional): Target word count (default: 1000)
language (string, optional): Language (default: English)
articleType (string, optional): Type of article (default: Article)
toneOfVoice (string, optional): Tone of voice (default: Professional)get_article
Get a specific article by ID with full content
articleId (string): The ID of the article to retrieveExample Usage
View Projects: Use
get_projectsto see all your projectsView Project Articles: Use
get_project_articleswith a project ID to see articles in that projectCreate Article: Use
create_articlewith a topic like "How to Use AI for Content Creation"Get Article Content: Use
get_articlewith the returned article ID to see the generated content
Getting Your API Key
Visit SemanticPen.com
Sign up or log in to your account
Go to your API settings to generate an API key
Copy the key and use it in your MCP configuration
Manual Installation (Alternative)
If you prefer to install manually:
npm install -g @semanticpen/mcp-serverThen use in your MCP config:
{
"command": "semantic-pen-mcp",
"env": {
"SEMANTIC_PEN_API_KEY": "your-api-key-here"
}
}Troubleshooting
"API key not configured": Make sure
SEMANTIC_PEN_API_KEYis set in the env section"API key verification failed": Check that your API key is valid and active
Server not starting: Ensure you have Node.js 18+ installed
Support
For issues or questions:
Visit SemanticPen.com for support
Check your API key is valid and has sufficient credits
Ensure stable internet connection for API calls
Available Tools
5 toolscreate_articleB
Create a new article
Inputs: targetArticleTopic (required), language, wordCount, articleType, +2 more.
get_articleA
Get a specific article by ID with full content
Inputs: articleId (required).
get_project_articlesA
Get all articles from a specific project by project ID
Inputs: projectId (required).
get_projectsA
Get all projects from your article queue
Inputs: no named parameters.
search_projectsB
Search projects by name
Inputs: projectName (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct resource and action: list projects, list articles per project, search projects, create article, get article. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern (get_projects, get_project_articles, search_projects, create_article, get_article), making the API predictable.
The server is scoped to a focused domain (projects and articles) and 5 tools is a reasonable, manageable number for this purpose.
The tool surface is read-heavy with only article creation. Missing operations include updating or deleting articles, creating/updating/deleting projects, and searching articles, which are significant gaps for full lifecycle management.
Maintenance
Related MCP Connectors
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Your Aurentia workspace — projects, CRM, tasks, deliverables — in Claude, Cursor or any MCP client.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude Code to interact with Jupyter notebooks, perform semantic search over knowledge files, and manage research projects.334MIT
- AlicenseAqualityCmaintenancePersistent knowledge base tools for Claude Code that store project context, decisions, and patterns locally across sessions, eliminating cold starts.846 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to launch and manage Cursor Cloud Agents on GitHub repos, including polling status, sending follow-ups, and reading conversations/PRs.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to search your local project notes and list indexed projects through hybrid keyword and semantic retrieval, returning relevant snippets with file and line references.MIT