MCP Tools

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

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

Example prompts:

“Delete my old test-post”

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”

get_analytics

View blog analytics. Requires Starter plan or above.

Parameter	Type	Required	Description
`period`	string	No	Time period (e.g. `7d`, `30d`)

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, schedule_post) automatically target the active blog once set.

Next Steps

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