Skip to main content

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

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

​
Installation

  1. Clone this repository:
git clone https://github.com/skaldlabs/skald-mcp
  1. Change directory to the project:
cd skald-mcp
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

​
Configuration

​
Cursor

  1. Open Cursor Settings (cmd+shift+p on macOS or ctrl+shift+p on Windows → “Cursor Settings”)
  2. Select “MCP” from the left sidebar and click “Add new global MCP server”
  3. 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

  1. Open Claude Desktop settings and navigate to the “Developer” tab
  2. Click “Edit Config”
  3. 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)
  1. 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

ParameterTypeRequiredDescription
querystringYesThe question to ask your knowledge base
project_idstringNoProject UUID (required when using Token Authentication)
ParameterTypeRequiredDescription
querystringYesThe search query
search_methodenumYesOne of: chunk_vector_search, title_contains, title_startswith
limitnumberNoMaximum results to return (1-50, default 10)
tagsstring[]NoFilter results by tags

​
skald-create-memo

ParameterTypeRequiredDescription
titlestringYesThe title of the memo (max 255 characters)
contentstringYesThe full content of the memo
project_idstringNoProject UUID (required when using Token Authentication)
metadataobjectNoCustom JSON metadata
reference_idstringNoExternal reference ID to match with your documents
tagsstring[]NoTags for categorization
sourcestringNoSource 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
⌘I