Using the eniston MCP server
The eniston MCP server lets AI assistants such as Claude, ChatGPT, Cursor or GitHub Copilot work with your knowledge bases. It uses the Model Context Protocol. Once it's connected, your assistant can:
browse knowledge bases, categories and articles
read full article content
search articles by keyword or by meaning (semantic search)
create and update categories and articles
Requirements
An active eniston subscription
An API access token. API tokens are available on the Business plan.
An MCP client that supports remote servers over Streamable HTTP
Semantic search only: the Enhanced Editor add-on, with Ask AI turned on for the knowledge base
1. Create an API token
The MCP server uses the same tokens as the eniston API.
Go to API Access Token.
Enter a name for the token, for example
Claude Desktop, and create it.Copy the token right away. It's shown only once.
Every request needs this header:
Authorization: Bearer YOUR_API_TOKEN
Tip: Create a separate token for each tool or device. If you stop using one, or a token leaks, you can revoke just that token on the access token page.
2. Connect your MCP client
Server URL: https://eniston.io/mcp
Transport: Streamable HTTP
Replace YOUR_API_TOKEN with your token in the examples below.
Generic configuration
Most clients that use an mcpServers config file accept this format:
{ "mcpServers": { "eniston": { "type": "streamable-http", "url": "https://eniston.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } }}
Claude Code
claude mcp add --transport http eniston https://eniston.io/mcp \ --header "Authorization: Bearer YOUR_API_TOKEN"
Claude Desktop
Claude Desktop's config file can't send custom headers to remote servers directly. Use the mcp-remote bridge instead. You need Node.js installed.
Open Settings → Developer → Edit Config and add:
{ "mcpServers": { "eniston": { "command": "npx", "args": [ "mcp-remote", "https://eniston.io/mcp", "--header", "Authorization:${ENISTON_AUTH}" ], "env": { "ENISTON_AUTH": "Bearer YOUR_API_TOKEN" } } }}
Restart Claude Desktop after you save the file.
VS Code (GitHub Copilot)
Create .vscode/mcp.json in your project, or run MCP: Open User Configuration to set it up for all projects:
{ "inputs": [ { "type": "promptString", "id": "eniston-token", "description": "eniston API token", "password": true } ], "servers": { "eniston": { "type": "http", "url": "https://eniston.io/mcp", "headers": { "Authorization": "Bearer ${input:eniston-token}" } } }}
VS Code asks for the token once and stores it securely.
Cursor
Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in your project:
{ "mcpServers": { "eniston": { "url": "https://eniston.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } }}
Grok Bot
Simply tell your Grok Bot to connect to https://eniston.io/mcp with an API token. Grok Bot should display a secure input field where you can paste your API token.
Check the connection
Ask your assistant:
"List my eniston knowledge bases."
If you see your knowledge bases, the connection works.
3. How your content is organized
Knowledge base├── Sections (optional, used to group categories)└── Categories ├── Subcategories (optional) └── Articles
Tools refer to items by ID, not by name. A typical flow is:
list-knowledge-basesto get theknowledge_base_idlist-categoriesto get thecategory_idlist-articlesorsearch-articlesto get thearticle_idget-article,update-article, and so on
You don't have to do this yourself. Your assistant looks up the IDs automatically.
4. Available tools
Tool | Type | Description |
|---|---|---|
| Read | Lists all knowledge bases you have access to |
| Read | Gets details, languages and sections of a knowledge base |
| Read | Lists categories and their subcategories |
| Read | Lists published articles |
| Read | Gets the full content of an article |
| Read | Searches articles by keyword |
| Read | Searches articles by meaning (needs the Enhanced Editor add-on) |
| Write | Creates a new category |
| Write | Updates an existing category |
| Write | Creates a new article |
| Write | Updates an existing article or moves it to another category |
Read tools
list-knowledge-bases
Lists every knowledge base you have access to.
Parameters: none
Example response
[ { "id": "9b1c2d3e-...", "name": "Product Help Center", "slug": "product-help", "role": "admin", "categories_count": 12, "articles_count": 148 }]
get-knowledge-base
Returns details about one knowledge base, including its languages and sections.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
Example response
{ "id": "9b1c2d3e-...", "name": "Product Help Center", "slug": "product-help", "custom_domain": "help.example.com", "categories_count": 12, "sections_count": 2, "articles_count": 148, "languages": [ { "id": "1", "label": "English", "code": "en", "is_default": true } ], "sections": [ { "id": "3", "name": "Getting started", "slug": "getting-started" } ]}
list-categories
Lists the categories in a knowledge base, with their subcategories and article counts.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
| integer | no | Only return categories in this section |
Example response
[ { "id": "4f7a...", "name": "Billing", "slug": "billing", "description": "Invoices, payments and plans", "section_id": 3, "articles_count": 9, "subcategories": [ { "id": "12", "name": "Invoices", "slug": "invoices" } ] }]
list-articles
Lists the published articles in a knowledge base, in the order they appear in the knowledge base. Draft and disabled articles aren't included.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
| string | no | Only return articles in this category |
| string | no | Only return articles in this subcategory |
Example response
[ { "id": "a81e...", "title": "How to download an invoice", "slug": "how-to-download-an-invoice", "category_id": "4f7a...", "subcategory_id": "12", "updated_at": "2026-09-14T10:22:03+00:00" }]
get-article
Returns the full HTML content of one article. This also works for draft and disabled articles.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the article |
Example response
{ "id": "a81e...", "title": "How to download an invoice", "slug": "how-to-download-an-invoice", "content": "<p>Go to <strong>Account → Invoices</strong> and ...</p>", "category": { "id": "4f7a...", "name": "Billing" }, "subcategory": { "id": "12", "name": "Invoices" }, "draft": false, "enabled": true, "updated_at": "2026-09-14T10:22:03+00:00"}
search-articles
Finds articles whose content contains your search term. Returns up to 20 results, each with a short snippet.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
| string | yes | Search term, 2–200 characters |
Example response
[ { "id": "a81e...", "title": "How to download an invoice", "slug": "how-to-download-an-invoice", "category_id": "4f7a...", "snippet": "Go to Account → Invoices and click the download icon next to ..." }]
search-articles-semantic
Finds articles by meaning rather than exact words. For example, a search for "how do I get my money back" also finds an article titled "Refund policy". Returns up to 10 results, each with a similarity score from 0 to 1.
Requires: the Enhanced Editor add-on, with Ask AI turned on for the knowledge base.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
| string | yes | A question or description, 2–500 characters |
Example response
[ { "article_id": "c03d...", "title": "Refund policy", "slug": "refund-policy", "similarity": 0.87, "content_snippet": "If you're not satisfied, you can request a full refund within 14 days ..." }]
Write tools
Changes you make through the MCP server take effect immediately. Articles that aren't drafts are published straight away and added to search and Ask AI automatically. If you want to review content before it goes live, ask your assistant to create articles as drafts.
create-category
Creates a new category in a knowledge base.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the knowledge base |
| string | yes | Category name (max. 255 characters) |
| string | no | URL slug. Generated from the name if you leave it out. |
| string | no | Category description |
| string | no | SEO meta description |
| integer | no | Section to put the category in |
The slug must be unique within the knowledge base.
Example response
{ "id": "e5b2...", "name": "Integrations", "slug": "integrations", "description": "Connect eniston with other tools", "meta_description": null, "section_id": null}
update-category
Updates a category. Only the fields you send are changed.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the category |
| string | no | New name |
| string | no | New URL slug (must be unique within the knowledge base) |
| string | no | New description |
| string | no | New SEO meta description |
| integer or null | no | Move the category to another section. Send |
Returns the updated category, in the same format as create-category.
create-article
Creates a new article in a category.
Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| string | yes | ID of the category | |
| string | yes | Article title (max. 255 characters) | |
| string | no | from title | URL slug (must be unique within the category) |
| string | no | Article content as HTML | |
| string | no | Short introduction (max. 255 characters) | |
| string | no | Search keywords (max. 255 characters) | |
| boolean | no |
| Whether the article is visible |
| boolean | no |
| Create the article as a draft |
Example response
{ "id": "f19a...", "title": "Connecting Slack", "slug": "connecting-slack", "category_id": "e5b2...", "draft": true, "enabled": true}
update-article
Updates an article. Only the fields you send are changed. You can also move the article to another category, in the same knowledge base or in a different one you have access to.
Parameter | Type | Required | Description |
|---|---|---|---|
| string | yes | ID of the article |
| string | no | Move the article to this category |
| string | no | New title |
| string | no | New URL slug (must be unique within the target category) |
| string | no | New content as HTML. This replaces the whole article body. |
| string | no | New introduction |
| string | no | New keywords |
| boolean | no | Show or hide the article |
Example response
{ "id": "a81e...", "title": "How to download an invoice", "slug": "how-to-download-an-invoice", "category_id": "4f7a...", "draft": false, "enabled": true, "updated_at": "2026-10-07T08:41:55+00:00"}
Tip: To edit part of an article, have your assistant call get-article first, change the HTML, and then send the complete updated content.
5. Example prompts
You don't need to call tools yourself. Describe what you want, and your assistant picks the right tools.
Explore and answer questions
"Which knowledge bases do I have in eniston, and how many articles does each one have?"
"Search the Product Help Center for articles about two-factor authentication and summarize them."
"Is there anything in our docs about refunds for annual plans?" (uses semantic search if you have it)
Review content
"List all articles in the Billing category that haven't been updated since January 2026."
"Read the article 'Getting started' and suggest improvements for clarity."
"Check every article in the 'API' category for broken or outdated code examples."
Create content
"Create a new category called 'Integrations' in the Product Help Center with a short description."
"Write a draft article in 'Integrations' explaining how to connect Slack, based on the notes below: …"
"Turn this support ticket conversation into a draft FAQ article in the Troubleshooting category."
Update content
"Fix typos and grammar in the article 'How to download an invoice'."
"Rename the 'Misc' category to 'Other topics' and change its slug to
other-topics.""Move the article 'Exporting data' from 'Account' to 'Data & Privacy'."
"Add SEO meta descriptions to all categories in the Product Help Center that don't have one."
6. Limits and good to know
Rate limit: 60 requests per minute per user. If you exceed it, the server responds with
429 Too Many Requests. Wait a moment and try again.Access: You can only see and change knowledge bases you're a team member of.
Content format: Article content is HTML. Ask your assistant to write HTML, for example
<h2>,<p>,<ul>and<a>tags, instead of Markdown.Images: Use image URLs. Don't embed images as Base64 (see Avoiding Base64 image sources).
Drafts: You can create an article as a draft, but you can't publish a draft or turn a published article back into a draft through MCP yet. Do this in the eniston editor.
Hidden articles:
list-articlesshows only published articles. Useget-articlewith a known ID to read drafts or disabled articles.Deleting: You can't delete content through MCP. See Deleting an article.
Search results: Keyword search returns up to 20 results. Semantic search returns up to 10.
7. Troubleshooting
Problem | Cause and fix |
|---|---|
| The token is missing, wrong or revoked. Check the |
| Your account has no active subscription or trial. |
| You've hit the rate limit. Wait a minute and try again. |
"You do not have access to this knowledge base / category / article." | Your account isn't a member of that knowledge base. |
"… not found." | The ID is wrong, or the item was deleted. Ask your assistant to list the items again. |
"A category with this slug already exists …" / "An article with this slug already exists …" | Choose a different slug, or leave it out so one is generated. |
"Semantic search requires the Enhanced add-on subscription." | Book the Enhanced Editor add-on, or use |
"AI features are not enabled for this knowledge base." | Turn on Ask AI in the knowledge base settings. |
Your client only shows read tools, or tools are missing | Your client cached an old tool list. Disconnect and reconnect the eniston server, or restart the client. |
Still stuck? Email support@eniston.io with your MCP client, the prompt you used and the error message.