Appie.run MCP server

Write on-brand articles, run AI chatbots and create trackable short links from Cursor, Claude or any other Model Context Protocol client.

Appie.run is an AI marketing stack that learns your brand from your website. This hosted MCP server gives your AI client the same brand context, so the content and answers it produces sound like you.

Try it free

New Appie.run accounts get 500 free credits, no card needed. That's enough for about 5 light articles or 500 chatbot replies. Read tools never spend credits.

Quick start

Sign up at Appie.run and open your project.
Go to API in the project sidebar and generate a key (it starts with esk_). Only project admins can do this.
Add the server to your MCP client config:

{
  "mcpServers": {
    "appie": {
      "type": "streamable-http",
      "url": "https://appie.run/mcp",
      "headers": { "Authorization": "Bearer YOUR_APPIE_API_KEY" }
    }
  }
}

The same config is in examples/mcp-config.json. Never commit a real key.

What you can do

Write articles in your voice. Start a light (~500 words) or deeply researched (~3,000 words) article using an author profile trained on your writing samples, then check its status until the draft is ready.
Manage brand context. Read and update the project Brain: your website, about text, brand voice, key messages, ideal customer and competitors.
Build and query chatbots. Create a chatbot, train it on text, URLs, sitemaps or your Appie articles, and ask it questions.
Create and track short links. Make links on s.appie.run and see clicks and unique visitors for the last 30 days.

Try asking your AI client

"Write a light article on onboarding emails for SaaS in our brand voice, and tell me when it's done."
"Create a support chatbot and train it on our sitemap."
"Make a short link for our pricing page and show me last month's clicks."

Tools

Tool	What it does	Cost
`create_short_link`	Creates a short link on s.appie.run, with an optional custom code	1 credit
`link_stats`	Clicks, uniques and a 30-day series for one link	Free
`create_article`	Starts a light or deeply researched article in an author's voice (async)	100 or 500 credits
`article_status`	Status and content of one article	Free
`list_authors`	Lists author profiles and their samples	Free
`create_author`	Creates an author, optionally with a first writing sample	See docs
`add_author_sample`	Adds a text or blog-URL sample to an author (up to 5)	See docs
`get_brain`	Reads the project's brand context	Free
`update_brain`	Updates selected brand context fields	See docs
`list_chatbots`	Lists chatbots and their training status	Free
`create_chatbot`	Creates a chatbot with optional prompt, model and temperature	Free
`add_chatbot_content`	Adds text, URL, sitemap or article knowledge to a chatbot	See docs
`chatbot_status`	Training status and recent sources for one chatbot	Free
`ask_chatbot`	Sends a message to a chatbot and returns its reply	1 credit

Every tool result includes credits_remaining. Writes spend the project's credits first, then the project owner's.

Permissions and errors

A key can only call tools for apps the person who generated it is allowed to use. Project owners can use every app. Regenerating a key revokes the old one immediately.

Error	Meaning
HTTP 401	Missing or revoked key
`app_not_allowed`	The key's owner can't use that app
`insufficient_credits`	Not enough credits (includes `required` and `available`)
`author_profile_required` / `writing_sample_required`	Add an author with a writing sample before `create_article`
`not_found`	The link or article isn't in this project

Documentation

Full reference: appie.run/docs/mcp

License

MIT, see LICENSE.

Appie.run MCP server