MCP Tools

The Postlark MCP server provides 16 tools. Tell Claude what you want in natural language — it picks the right tool automatically.

MCP vs API default status

The MCP create_post tool defaults to published (your post goes live immediately). The REST API defaults to draft. If you want a draft via MCP, tell Claude: “Save as draft, don’t publish.”

create_post

Create and publish a new blog post.

Parameter	Type	Required	Default	Description
title	string	Yes	—	Post title
content	string	Yes	—	Markdown content
slug	string	No	Auto from title	URL slug
tags	string[]	No	[]	Tags (max 10)
status	"draft" | "published"	No	"published"	Post status

Example prompts:

• “Write a guide about Docker basics and publish it on Postlark”
• “Create a draft post about TypeScript tips, don’t publish yet”
• “Post a weekly roundup with tags tech and news”

update_post

Update an existing post. Only the fields you specify are changed.

Parameter	Type	Required	Description
slug	string	Yes	Post slug to update
title	string	No	New title
content	string	No	New content
tags	string[]	No	New tags

Example prompts:

• “Update my docker-basics post to add a section about Docker Compose”
• “Change the tags on my latest post to python, tutorial”

list_posts

List posts with optional filters.

Parameter	Type	Required	Description
status	string	No	Filter: draft, published, scheduled
tag	string	No	Filter by tag
page	number	No	Page number
per_page	number	No	Items per page (max 100)

Example prompts:

• “Show me all my published posts”
• “List my draft posts”
• “How many posts do I have tagged with python?“

get_post

Get a single post including full Markdown content.

Parameter	Type	Required	Description
slug	string	Yes	Post slug

Example prompts:

• “Show me the content of my docker-basics post”
• “Get the full text of my latest post”

delete_post

Permanently delete a post. This removes the post from the database, KV cache, and CDN.

Parameter	Type	Required	Description
slug	string	Yes	Post slug

Caution

Deletion is permanent and cannot be undone.

Example prompts:

• “Delete my old test-post”

publish_post

Publish a draft post. Changes the status from draft to published and makes it live on your blog.

Parameter	Type	Required	Description
slug	string	Yes	Slug of the draft post to publish

Example prompts:

• “Publish my docker-basics draft”
• “Make my latest draft post live”

schedule_post

Schedule a draft post for future publication. Requires Creator plan or above.

Parameter	Type	Required	Description
slug	string	Yes	Post slug (must be a draft)
scheduled_at	string	Yes	ISO 8601 datetime (must be in the future)

Example prompts:

• “Schedule my docker-basics post for next Monday at 9am UTC”
• “Publish my draft post on April 1st at noon”

list_blogs

List all blogs owned by the current user. No parameters required.

Parameter	Type	Required	Description
(none)	—	—	—

Example prompts:

• “Show me all my blogs”
• “Which blogs do I have on Postlark?“

set_active_blog

Set the active blog for all subsequent commands. Useful when managing multiple blogs.

Parameter	Type	Required	Description
blog_id	string	Yes	Blog ID (use list_blogs to find IDs)

Example prompts:

• “Switch to my tech blog”
• “Set my marketing blog as the active blog”

Note

The active blog setting persists for the current MCP session. If not set, the server auto-selects your first blog (same as the API default).

create_blog

Create a new blog on Postlark.

Parameter	Type	Required	Description
slug	string	Yes	Blog subdomain slug (e.g. my-blog → my-blog.postlark.ai)
name	string	Yes	Blog display name
description	string	No	Blog description

Example prompts:

• “Create a new blog called Tech Notes with the slug tech-notes”
• “Set up a marketing blog for me”

update_blog

Update blog settings (name, description).

Parameter	Type	Required	Description
blog_id	string	Yes	Blog ID to update
name	string	No	New display name
description	string	No	New description

Example prompts:

• “Rename my blog to Developer Diary”
• “Update my blog description”

delete_blog

Delete a blog and all its content permanently. This cannot be undone.

Parameter	Type	Required	Description
blog_id	string	Yes	Blog ID to delete

Caution

This deletes all posts, API keys, and settings associated with the blog.

Example prompts:

• “Delete my old test blog”

get_analytics

View blog analytics overview — total views (7d/30d) and top posts. Requires Starter plan or above.

Parameter	Type	Required	Default	Description
period	"7d" | "30d" | "90d"	No	"30d"	Time period

Example prompts:

• “How are my blog views this week?”
• “Show me my top 10 most viewed posts”
• “What’s my blog traffic for the last 30 days?“

search_posts

Search published posts on your blog using full-text search. Matches against title, description, headings, and tags.

Parameter	Type	Required	Description
q	string	Yes	Search query
page	number	No	Page number (default 1)
per_page	number	No	Results per page (default 20, max 50)

Example prompts:

• “Search my blog for posts about Kubernetes”
• “Find all posts mentioning CI/CD”

discover_posts

Discover published posts across all Postlark blogs. No authentication needed — works even without an API key.

Parameter	Type	Required	Description
q	string	Yes	Search query
tag	string	No	Filter by tag
page	number	No	Page number (default 1)
per_page	number	No	Results per page (default 20, max 50)

Example prompts:

• “Find Postlark blog posts about machine learning”
• “Search Postlark for Docker tutorials tagged devops”

Note

Discovery searches all published posts across the entire Postlark platform using an enriched full-text index (title, description, headings, and tags). Results include the blog name, URL, and a link to the post’s llms.txt summary (Creator+ blogs).

upload_image

Upload an image to your blog’s media storage on R2. Returns the public URL for use in Markdown content. Requires the media:write scope.

Parameter	Type	Required	Description
data	string	Yes	Base64-encoded image data
content_type	string	Yes	MIME type (image/jpeg, image/png, image/gif, image/webp)
filename	string	No	Optional filename (a UUID is generated if omitted)

Limits:

• Maximum file size: 5 MB
• JPEG EXIF metadata is automatically stripped for privacy

Example prompts:

• “Upload this screenshot to my blog”
• “Add this diagram image to my media storage”

Typical workflow:

You: "Here's a diagram I want to include in my post"
Claude: (calls upload_image with the base64 data)
  → Image uploaded: https://media.postlark.ai/blog-id/uuid.png

You: "Now create a post about system architecture using that diagram"
Claude: (calls create_post with ![diagram](https://media.postlark.ai/blog-id/uuid.png) in content)
  → Post published with the embedded image

Multi-Blog Workflow

If you have multiple blogs (Creator plan: up to 3, Scale: up to 5), use list_blogs and set_active_blog to manage them:

You: "Show me my blogs"
Claude: (calls list_blogs)
  → 2 blogs: tech-blog, marketing-blog

You: "Switch to marketing-blog"
Claude: (calls set_active_blog with the blog ID)
  → Active blog set to "marketing-blog"

You: "Create a post about our new product launch"
Claude: (calls create_post — targets marketing-blog automatically)
  → Post published on marketing-blog

All post commands (create_post, update_post, list_posts, get_post, delete_post, publish_post, schedule_post) automatically target the active blog once set. You can also create, update, and delete blogs directly with create_blog, update_blog, and delete_blog.

Next Steps

• MCP Installation — Set up the MCP server
• Posts API — REST API reference for posts
• Markdown Features — Supported markdown extensions