Skald MCP - Skald Docs

Features

The Skald MCP server allows you to interact with your Skald knowledge base through a familiar interface like Cursor or Claude. It let’s you chat with your knowledge base, search through your memos, and create new memos. The Skald MCP server provides three powerful tools:

1. skald-chat

Ask Skald questions about your knowledge base in natural language.

2. skald-search

Search through your memos using multiple methods:

Semantic search (chunk_vector_search) - Find relevant content by meaning
Title contains (title_contains) - Case-insensitive substring matching
Title starts with (title_startswith) - Case-insensitive prefix matching

3. skald-create-memo

Create new memos that are automatically processed, summarized, tagged, chunked, and indexed for search.

Setup

Prerequisites

A Skald account with an API key. Get yours at platform.useskald.com
Node.js 18.0.0 or higher

Installation

Clone this repository:

git clone https://github.com/skaldlabs/skald-mcp

Change directory to the project:

cd skald-mcp

Install dependencies:

npm install

Build the project:

npm run build

Configuration

Cursor

Open Cursor Settings (cmd+shift+p on macOS or ctrl+shift+p on Windows → “Cursor Settings”)
Select “MCP” from the left sidebar and click “Add new global MCP server”
Add the following configuration:

{
  "mcpServers": {
    "skald": {
      "type": "command",
      "command": "node ABSOLUTE_PATH_TO_PROJECT/build/index.js --key=YOUR_SKALD_API_KEY"
    }
  }
}

Replace:

ABSOLUTE_PATH_TO_PROJECT with the full path to your skald-mcp directory
YOUR_SKALD_API_KEY with your Skald API key

Tip: Right-click on /build/index.js in Cursor and select “Copy Path” to get the absolute path.

Claude Desktop

Open Claude Desktop settings and navigate to the “Developer” tab
Click “Edit Config”
Add the following configuration:

{
  "mcpServers": {
    "skald": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_PROJECT/build/index.js"
      ],
      "env": {
        "SKALD_API_KEY": "YOUR_SKALD_API_KEY"
      }
    }
  }
}

Replace:

ABSOLUTE_PATH_TO_PROJECT with the full path to your skald-mcp directory
YOUR_SKALD_API_KEY with your Skald API key

Environment variables:

SKALD_API_KEY: Your Skald API key (required)

Restart Claude Desktop

Usage Examples

Chat with your knowledge base

Ask Cursor/Claude: "Check Skald for what are the instructions for running our Django server locally."

The assistant will query your Skald knowledge base and return an answer.

Search for memos

Ask Cursor/Claude: "Search Skald for the docs about our product vision"

The assistant will use the skald-search tool with semantic search to find relevant memos.

Create a new memo

Ask Cursor/Claude: "Generate an API reference for my endpoints and upload it to Skald"

The assistant will create a new memo in your Skald knowledge base, which will be automatically processed and made searchable.

Tool Parameters

skald-chat

Parameter	Type	Required	Description
`query`	string	Yes	The question to ask your knowledge base
`project_id`	string	No	Project UUID (required when using Token Authentication)

skald-search

Parameter	Type	Required	Description
`query`	string	Yes	The search query
`search_method`	enum	Yes	One of: `chunk_vector_search`, `title_contains`, `title_startswith`
`limit`	number	No	Maximum results to return (1-50, default 10)
`tags`	string[]	No	Filter results by tags

skald-create-memo

Parameter	Type	Required	Description
`title`	string	Yes	The title of the memo (max 255 characters)
`content`	string	Yes	The full content of the memo
`project_id`	string	No	Project UUID (required when using Token Authentication)
`metadata`	object	No	Custom JSON metadata
`reference_id`	string	No	External reference ID to match with your documents
`tags`	string[]	No	Tags for categorization
`source`	string	No	Source of the content (useful for integrations)

Development

Build

npm run build

Lint

npm run lint

Fix linting issues

npm run lint:fix

Troubleshooting

API Key Issues

If you get an error about a missing API key:

For Cursor: Ensure the --key argument is set in your config
For Claude Desktop: Ensure SKALD_API_KEY is set in the env section

Module Not Found

If you see “Cannot find module ‘@skald-labs/skald-node’“:

npm install
npm run build

Connection Issues

Check the debug logs:

Cursor: Check the MCP server logs in Cursor settings
Claude Desktop: Check the logs in Claude Desktop developer settings

​Features

​1. skald-chat

​2. skald-search

​3. skald-create-memo

​Setup

​Prerequisites

​Installation

​Configuration

​Cursor

​Claude Desktop

​Usage Examples

​Chat with your knowledge base

​Search for memos

​Create a new memo

​Tool Parameters

​skald-chat

​skald-search

​skald-create-memo

​Development

​Build

​Lint

​Fix linting issues

​Troubleshooting

​API Key Issues

​Module Not Found

​Connection Issues