title: Kogna MCP Server emoji: 🤖 colorFrom: blue colorTo: purple sdk: docker pinned: false license: mit

Kogna MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Kogna's multi-agent AI avatar system.

Installation

Install pipx (if you don't have it)

Install kognamcp

Testing the Installation

1. Test the command is available

You should see:

2. Test the MCP bridge connection

You should get a response like:

Configuration

Find the kognamcp path

First, find the full path to the kognamcp command:

This will output something like /Users/username/.local/bin/kognamcp

Configure your MCP client

Add this configuration to your MCP client:

Replace

For example, if which kognamcp returns /Users/john/.local/bin/kognamcp, your config should be:

Troubleshooting

"Command not found: kognamcp"

1. Make sure the installation completed successfully:

   pipx list | grep kognamcp

2. Add pipx to your PATH:

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

3. Restart your terminal/IDE

"spawn kognamcp ENOENT" or similar errors

This happens when your MCP client can't find the kognamcp command. The solution is to use the full path:

1. Find the full path:

   which kognamcp

2. Copy the exact output and use it in your MCP configuration

3. Restart your MCP client

Connection errors

The bridge connects to https://kogna.up.railway.app/mcp. Make sure you have internet access.

Available Tools

• start_kogna_conversation - Start a new conversation with Kogna avatars

• send_kogna_message - Send a message to the current conversation

• list_kogna_avatars - List available avatars and their specialties

• list_kogna_rooms - List available rooms and their descriptions

• switch_kogna_avatar - Switch to a different avatar

• switch_kogna_room - Switch to a different room

• get_kogna_conversation_history - Get conversation history

• get_kogna_system_info - Get system information

Usage

Once configured, you can use Kogna through your MCP client:

• "Start a Kogna conversation"

• "List the available Kogna avatars"

• "Switch to the business room"

• "Ask the strategist avatar about market positioning"

Requirements

• Python 3.8+

• Internet connection (connects to Kogna backend)

License

MIT License