Aiqbee Brain MCP Server

Manage architecture, portfolio, and digital strategy knowledge graphs through AI conversation. Search, create, and link neurons (knowledge units) across your Aiqbee brain via 25 MCP tools supporting Claude, Cursor, VS Code, and other AI clients.

com.aiqbee/brain

Example prompts for Aiqbee Brain

Paste any of these into Agent Studio after connecting Aiqbee Brain.

Search my brain for all cloud migration decisions and their relationships

Create a neuron about our API gateway strategy and link it to deployment

List all brains I have access to and show me the Enterprise Architecture template

Who has access to this brain and grant read access to alice@example.com

Excerpted from the project's README — boilerplate sections (license, changelog, contributing) omitted for clarity.

Aiqbee AI

Connect AI assistants to your Aiqbee brains via the Model Context Protocol.

Search, create, and link knowledge across your architecture, portfolio, and digital strategy - all through natural conversation with your AI assistant.

Supported Clients

AI Tool	Integration	Setup
Claude Code	Plugin	`claude plugin install AIQBee/aiqbee-ai`
Claude Desktop	MCP Config	JSON config below
Cursor	MCP Config	JSON config below
VS Code / Copilot	MCP Config	JSON config below
Gemini CLI	Extension	`gemini extensions install https://github.com/AIQBee/aiqbee-ai`
ChatGPT	MCP Config	JSON config below
Windsurf	MCP Config	JSON config below
Any stdio client	npx	`npx -y @aiqbee/mcp`

Quick Start

Claude Code

claude plugin install AIQBee/aiqbee-ai

Restart Claude Code after installation.

Gemini CLI

gemini extensions install https://github.com/AIQBee/aiqbee-ai

Restart Gemini CLI and authenticate when prompted.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aiqbee": {
      "url": "https://mcp.aiqbee.com/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "aiqbee": {
      "url": "https://mcp.aiqbee.com/mcp"
    }
  }
}

VS Code

Add to your settings.json:

{
  "mcp": {
    "servers": {
      "aiqbee": {
        "type": "sse",
        "url": "https://mcp.aiqbee.com/mcp"
      }
    }
  }
}

npx (stdio clients)

For MCP clients that only support stdio transport:

{
  "mcpServers": {
    "aiqbee": {
      "command": "npx",
      "args": ["-y", "@aiqbee/mcp"]
    }
  }
}

Other MCP Clients

For any MCP-compatible client, point it at:

https://mcp.aiqbee.com/mcp

Authentication

Aiqbee uses OAuth 2.0 with secure authorization. When you first connect, your MCP client will prompt you to sign in. The server supports:

Public clients (Claude Desktop, Cursor): Standard PKCE flow
Confidential clients (ChatGPT): Server-side PKCE with callback

No API keys needed - just sign in with your existing Aiqbee account.

Available Tools (25)

Brain Discovery & Management

Tool	Description	Permission
`aiqbee_list_brains`	List all brains you have access to	Read
`aiqbee_get_brain_info`	Get brain metadata and statistics	Read
`aiqbee_edit_is_allowed`	Check if MCP editing is enabled for a brain	Read
`aiqbee_list_brain_templates`	List available brain templates for brain creation	Read
`aiqbee_create_brain`	Create a new brain (optionally from a template)	—
`aiqbee_update_brain`	Update brain name, description, or settings	Owner
`aiqbee_delete_brain`	Delete a brain permanently	Owner

Search & Retrieval

Tool	Description	Permission
`aiqbee_search`	Search neurons in your knowledge graph	Read
`aiqbee_fetch`	Get full neuron content and metadata	Read
`aiqbee_list_neurons`	Paginated neuron listing with filtering	Read

Neuron Types

Tool	Description	Permission
`aiqbee_list_neuron_types`	List all neuron types in a brain	Read
`aiqbee_add_neuron_type`	Create a new neuron type	Owner
`aiqbee_edit_neuron_type`	Update a neuron type's properties	Owner
`aiqbee_delete_neuron_type`	Delete a neuron type (with optional neuron reassignment)	Owner

Neurons

Tool	Description	Permission
`aiqbee_create_neuron`	Create a new neuron in your brain	ReadWrite
`aiqbee_update_neuron`	Update an existing neuron	ReadWrite
`aiqbee_delete_neuron`	Delete a neuron	ReadWrite

Relationships

Tool	Description	Permission
`aiqbee_get_relationships`	Get incoming/outgoing relationships for a neuron	Read
`aiqbee_create_relationship`	Create a link between two neurons	ReadWrite
`aiqbee_update_relationship`	Update an existing relationship	ReadWrite
`aiqbee_delete_relationship`	Remove a relationship	ReadWrite

Access Control

Tool	Description	Permission
`aiqbee_list_users`	List users with access to a brain	Read
`aiqbee_grant_access`	Grant a user access to a brain	Owner
`aiqbee_revoke_access`	Revoke a user's access to a brain	Owner
`aiqbee_batch_update_access`	Replace all access permissions in one operation	Owner

Example Prompts

Once connected, try asking your AI assistant:

"List all my brains"
"Show me the available brain templates"
"Create a new brain called 'Cloud Architecture' using the Enterprise Architecture template"
"Search my brain for anything related to cloud migration"
"Show me all the architecture decisions we've made"
"Create a new neuron about our API gateway strategy"
"Link the microservices neuron to the deployment pipeline neuron"
"What are the relationships for the data platform neuron?"
"Who has access to this brain? Grant read access to alice@example.com"
"Summarize the key concepts in my digital strategy brain"

Aiqbee Brain MCP server — FAQ

Common questions about connecting and running Aiqbee Brain.

What is a neuron and how does it differ from a document?

A neuron is a discrete knowledge unit in Aiqbee's knowledge graph that can be linked to other neurons via relationships (synapses). Unlike flat documents, neurons form a queryable network where you can traverse connections and discover related concepts through the MCP tools.

Do I need an API key to use this MCP server?

No. The server uses OAuth 2.0 authentication—you sign in with your existing Aiqbee account when you first connect. The MCP client will prompt you to authorize, and no API keys are required.

Which AI clients does this MCP server support?

It supports Claude Code, Claude Desktop, Cursor, VS Code with Copilot, Gemini CLI, ChatGPT, Windsurf, and any stdio-based MCP client. Setup varies by client but typically involves adding a config entry pointing to https://mcp.aiqbee.com/mcp.

Can I create and edit neurons through the MCP server or only read them?

You can both read and write. The server includes tools to create neurons, update them, delete them, and manage relationships. Permissions depend on your role (Owner, ReadWrite, Read) in the brain.

What happens if I don't have edit permissions on a brain?

The README does not document the exact behavior, but the tools include permission checks (e.g., `aiqbee_edit_is_allowed`). If you lack ReadWrite or Owner permissions, write operations will likely fail; you can still search and fetch neurons with Read access.