MCP connector
Hashnode MCP server
Publish Markdown articles to your Hashnode blog from Claude or ChatGPT.
This is the posterly MCP server, used for Hashnode. The same connection works from Claude, ChatGPT, Cursor, and other MCP clients. It is not a separate Hashnode-only download.
What you can do on Hashnode
Hashnode is your own blog, and posterly publishes to a Hashnode publication rather than a shared community feed. Your AI client writes a Markdown article, gives it a title, and publishes it to the publication that was captured when you connected, with up to 100,000 characters of body. The publication must be on Hashnode Pro, because Hashnode only opens its publishing API to Pro publications.
If you run more than one publication, tell the assistant which one and it can target it by ID. A post takes 4 tags at most, and the first attached image is used as the cover art. The connection uses a personal access token from your Hashnode account settings under Developer.
Unlike Dev.to, posterly does not set a canonical URL for Hashnode, so it fits articles that start life on your Hashnode blog. If a post began elsewhere, cross-post it to Dev.to with a canonical link instead. Articles are published live at the scheduled time, video is not supported, and the MCP server does not read Hashnode analytics.
- Text posts
- Images
- Multi-image
- Custom cover
- Extra tagging tools
Post types: text, image. Analytics are not read for this platform.
Tools
These are the tools your AI client uses for Hashnode. Ask it to call list_platforms with view=schema and the account_id before it sets anything specific to Hashnode.
Account and connection
whoamiWho am Ilist_accountsConnected accountslist_platformsPlatformscreate_connect_sessionStart a connect sessionconnect_accountConnect with credentials
Posts
validate_postValidate a postcreate_postCreate a postShow the caption, account, and time, then wait for confirmation before confirm=true.
create_posts_batchCreate posts in bulk1 to 25 posts in one confirmed request.
update_postEdit a postShow the caption, account, and time, then wait for confirmation before confirm=true.
list_postsPostsget_postOne postdelete_postDelete postsLive removal needs an eligible connection and confirm_published. A refusal keeps the posterly record.
find_available_slotFind a free slotgenerate_captionsGenerate captions
Media
upload_mediaUpload mediaHosted requests are about 4MB, so this path is for small files. Large files use create_signed_upload or create_media_drop.
create_signed_uploadSigned upload linkcreate_media_dropMedia drop linklist_mediaMedia library
How to connect
- Add the hosted server in Claude, ChatGPT, Cursor, or another MCP client. Server URL:
https://www.poster.ly/api/mcp. Sign in with posterly OAuth and press Allow. Use the www host. In ChatGPT, write actions need a Business, Enterprise, or Edu plan. - Or, in a client that can run a local process (Cursor, Claude Code, Windsurf, and similar), use
npx -y posterly-mcp-server@latestwith aPOSTERLY_API_KEYplaceholder in that client's MCP config. - Call whoami and list_accounts so you know which workspace the client is using.
- Connect Hashnode with the method below, then call list_platforms with view=schema and the account_id.
Hashnode
Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.
- Personal access token (required): Hashnode personal access token from Account Settings, Developer.
Example prompts
- Publish this article to my Hashnode blog on Wednesday at 10am with the title "Shipping weekly" and the tags startups and productivity.
- Write a how-to article from these notes and publish it to the Hashnode publication with this ID: <your publication ID>.
- Schedule this Markdown post to Hashnode with the first screenshot as the cover image.
Hashnode limits
- Caption or text
- 100,000 characters.
Request rates depend on your plan. The posterly MCP page lists them.
Pricing
API and MCP access is an add-on to any posterly plan. Starter plus API is $10 a month, charged now with no free trial on this checkout.
FAQ
What is the Hashnode MCP server?
It is the posterly MCP server, not a separate product. Connect it once and the same connection covers Hashnode and 17 other platforms, from Claude, ChatGPT, Cursor, and other MCP clients.
How do I connect Hashnode?
Add the hosted server at https://www.poster.ly/api/mcp and sign in with posterly, or run npx -y posterly-mcp-server@latest in a client that can start a local process. Hashnode: Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.
Do I need Hashnode Pro to publish from the MCP server?
Yes. Hashnode only opens its publishing API to Pro publications, so connecting or publishing fails with a clear error on a free one. Upgrade the publication to Hashnode Pro, then reconnect it in posterly.
Which Hashnode blog does the post go to?
The publication that was captured when you connected the account. If you run more than one publication, you can point a post at a different one by its ID.
How is Hashnode different from Dev.to in the MCP server?
Hashnode posts land on your own publication, which is your blog, while Dev.to posts land in the DEV Community feed. Dev.to supports a canonical URL for cross-posting and Hashnode does not, so start an article on Hashnode only when Hashnode is where it should live.
Keep reading
MCP
posterly MCP server
Hosted OAuth setup, the local npm package, and the full tool list.
Scheduler
Hashnode scheduler
Schedule Hashnode from the posterly calendar and composer.
Guide
Hashnode guide
Read the long Hashnode guide, then come back to connect it.
Pricing
posterly pricing
Compare plans, then add API and MCP at checkout.