playbooks

home / mcp / brianknows mcp server

BrianKnows MCP Server

Unofficial MCP to use BrianKnows API for DeFI knowledge

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "antoncoding-mcp-brianknows": {
      "command": "npx",
      "args": [
        "mcp-brianknows"
      ],
      "env": {
        "BRIAN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can connect Claude Desktop to BrianKnows’ blockchain knowledge base through an MCP server. This lets you perform quick checks, search for blockchain and DeFi information, and chat with a BrianKnows agent while keeping control over your data and API usage.

How to use

Use the BrianKnows MCP server with your MCP-enabled client to run three core actions: ping the BrianKnows API server to confirm responsiveness, search the knowledge engine for blockchain and DeFi information, and chat with the BrianKnows agent about DeFi protocols. Your client will cache the five most recent searches for fast reference. Use these capabilities to quickly verify availability, extract targeted insights, and have interactive conversations with the knowledge base.

How to install

Prerequisites you need before starting:

  • Node.js (v18 or higher)
  • Claude Desktop
  • A BrianKnows API key

1. Install Node.js from the official sources if you haven’t already (ensure you are using a version of Node.js that is v18 or newer).

2. Set up Claude Desktop and make sure MCP is enabled for your workflow. You will configure the MCP server in your Claude Desktop settings.

3. Prepare your BrianKnows API key from your BrianKnows account to authorize API access.

Configuration

Add the following MCP server configuration to your Claude Desktop MCP settings. This config runs the server locally via npx and passes your API key as an environment variable.

{
  "mcpServers": {
    "brianknows": {
      "command": "npx",
      "args": ["mcp-brianknows"],
      "env": {
        "BRIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Example usage

Can you check if the BrianKnows API is online? Use BrianKnows to search for information about Ethereum's Layer 2 solutions. Ask the BrianKnows agent to explain how Uniswap V3 works.

Notes on usage and capabilities

- Multiple knowledge bases are available, including public-knowledge-box (default) and several specialized KBs for different protocols. You can switch between knowledge bases to tailor results to your topic.

- Searches are cached to provide quick access to your five most recent queries. This cache helps you iterate on your research without repeating exact queries.

- The server includes user-friendly error handling to guide you when something goes wrong and supports type-safe interactions through a TypeScript implementation.

Security and notes

Keep your BrianKnows API key secure. Do not share it in public environments. If you rotate the key, update the environment variable in your MCP configuration accordingly.

Tools and capabilities overview

Ping Tool: Check if the BrianKnows API server is reachable.

Search Tool: Query BrianKnows’ knowledge engine for blockchain and DeFi information.

Agent Tool: Interact with the BrianKnows agent on DeFi protocols.

Available tools

Ping

Check if the BrianKnows API server is responsive and reachable.

Search

Query BrianKnows' knowledge engine to retrieve blockchain and DeFi information.

Agent

Chat with the BrianKnows agent about DeFi protocols and related concepts.