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.

  1. Go to API Access Token.

  2. Enter a name for the token, for example Claude Desktop, and create it.

  3. 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:

  1. list-knowledge-bases to get the knowledge_base_id

  2. list-categories to get the category_id

  3. list-articles or search-articles to get the article_id

  4. get-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

list-knowledge-bases

Read

Lists all knowledge bases you have access to

get-knowledge-base

Read

Gets details, languages and sections of a knowledge base

list-categories

Read

Lists categories and their subcategories

list-articles

Read

Lists published articles

get-article

Read

Gets the full content of an article

search-articles

Read

Searches articles by keyword

search-articles-semantic

Read

Searches articles by meaning (needs the Enhanced Editor add-on)

create-category

Write

Creates a new category

update-category

Write

Updates an existing category

create-article

Write

Creates a new article

update-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

knowledge_base_id

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

knowledge_base_id

string

yes

ID of the knowledge base

section_id

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

knowledge_base_id

string

yes

ID of the knowledge base

category_id

string

no

Only return articles in this category

subcategory_id

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

article_id

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

knowledge_base_id

string

yes

ID of the knowledge base

query

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

knowledge_base_id

string

yes

ID of the knowledge base

query

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

knowledge_base_id

string

yes

ID of the knowledge base

name

string

yes

Category name (max. 255 characters)

slug

string

no

URL slug. Generated from the name if you leave it out.

description

string

no

Category description

meta_description

string

no

SEO meta description

section_id

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

category_id

string

yes

ID of the category

name

string

no

New name

slug

string

no

New URL slug (must be unique within the knowledge base)

description

string

no

New description

meta_description

string

no

New SEO meta description

section_id

integer or null

no

Move the category to another section. Send null to remove it from its section.

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

category_id

string

yes

ID of the category

title

string

yes

Article title (max. 255 characters)

slug

string

no

from title

URL slug (must be unique within the category)

text

string

no

Article content as HTML

introtext

string

no

Short introduction (max. 255 characters)

keywords

string

no

Search keywords (max. 255 characters)

enabled

boolean

no

true

Whether the article is visible

draft

boolean

no

false

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

article_id

string

yes

ID of the article

category_id

string

no

Move the article to this category

title

string

no

New title

slug

string

no

New URL slug (must be unique within the target category)

text

string

no

New content as HTML. This replaces the whole article body.

introtext

string

no

New introduction

keywords

string

no

New keywords

enabled

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-articles shows only published articles. Use get-article with 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

401 Unauthorized

The token is missing, wrong or revoked. Check the Authorization: Bearer … header, or create a new token.

403 – "An active subscription is required to use the MCP server."

Your account has no active subscription or trial.

429 Too Many Requests

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 search-articles instead.

"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.


Was this article helpful?