Amplemarket Knowledge Base MCP Server

MCP Amplemarket Knowledge Base Server

A Model Context Protocol (MCP) server that provides seamless access to the Amplemarket Knowledge Base via Pylon's API. Designed specifically for Claude Desktop and other MCP-compatible clients.

Features

🔍 Smart Search: Search through Amplemarket articles by title and content
📄 Article Access: Retrieve full article content by ID or slug
📚 Complete Catalog: Get all available Amplemarket articles at once
🌐 Resource Support: Access articles via URI scheme
⚡ Fast Caching: Built-in 60-second cache to reduce API calls
🔒 Secure: Environment-based API token configuration
🎯 Focused: Hardcoded for Amplemarket knowledge base - no configuration needed

Setup

Install dependencies:
npm install
Configure your API key:
cp .env.example .env
Then edit the .env file and add your Pylon API token:
PYLON_API_TOKEN=your_actual_api_token_here
Important: Replace your_actual_api_token_here with your real Pylon API token. You can get this token from your Pylon dashboard.
Build the project:
npm run build
Test the server:
npm start

Configuration

Environment Variables

PYLON_API_TOKEN: Your Pylon API token (required)

Claude Desktop Integration

Add to your Claude Desktop mcp.json configuration:

{
  "mcpServers": {
    "pylon-kb": {
      "command": "node",
      "args": ["./dist/src/index.js"],
      "cwd": "/path/to/mcp-pylon-kb",
      "env": { 
        "PYLON_API_TOKEN": "your_actual_api_token_here"
      }
    }
  }
}

Note: Replace /path/to/mcp-pylon-kb with the actual path to this project directory, and your_actual_api_token_here with your real Pylon API token.

Tools

`kb.search`

Search for articles in the knowledge base.

Parameters:

query (string, required): Search query
limit (number, optional): Maximum results (1-100, default: 10)
collectionId (string, optional): Limit search to specific collection

`kb.getArticle`

Get a specific article by ID or slug.

Parameters:

id (string, optional): Article ID
slug (string, optional): Article slug

Note: Either id or slug must be provided.

`kb.getCollection`

Get collection metadata and articles.

Parameters:

id (string, required): Collection ID

Resources

The server supports the pylon-article:// URI scheme:

pylon-article://<article-id> - Get article by ID
pylon-article://<article-slug> - Get article by slug
pylon-article://help - Get resource usage help

API Client

The Pylon API client (src/pylon.ts) handles:

Authentication with Bearer token
HTTP requests via undici
HTML to text conversion
In-memory caching with TTL
Error handling

Development

# Install dependencies
npm install

# Build
npm run build

# Development mode (build + run)
npm run dev

# Run tests
npm test

Project Structure

mcp-pylon-kb/
├── package.json
├── tsconfig.json
├── .env.example
├── README.md
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── pylon.ts          # Pylon API client
│   ├── schema.ts         # Zod validation schemas
│   └── tools/            # MCP tool implementations
│       ├── kbSearch.ts
│       ├── kbGetArticle.ts
│       └── kbGetCollection.ts
└── tests/
    ├── htmlToText.test.ts
    └── searchAdapter.test.ts

Security

API tokens are never logged or exposed in responses
All sensitive data is read from environment variables
Input validation with Zod schemas
Error messages don't leak sensitive information

License

MIT

Amplemarket Knowledge Base MCP Server

MCP Amplemarket Knowledge Base Server

Features

Setup

Configuration

Environment Variables

Claude Desktop Integration

Tools

`kb.search`

`kb.getArticle`

`kb.getCollection`

Resources

API Client

Development

Project Structure

Security

License

New MCP Servers

MCP directory API