Expert Server
FreeNot checkedEnables MCP-compatible agents to query beliefs, search documents, and explore reasoning chains from expert-service knowledge bases.
About
Enables MCP-compatible agents to query beliefs, search documents, and explore reasoning chains from expert-service knowledge bases.
README
MCP server for expert-service knowledge bases. Lets any MCP-compatible agent query beliefs, search documents, and explore reasoning chains.
Install
uv tool install git+https://github.com/benthomasson/expert-mcp-server
Configure
Create a .expert.toml in your project root:
url = "https://expert.ftl2.com"
project = "your-project-name"
api_key = "your-api-key"
Or set environment variables: EXPERT_URL, EXPERT_API_KEY, EXPERT_PROJECT.
Global config can also go in ~/.config/expert/config.toml under [default].
Usage
Claude Code
claude mcp add expert-service -- expert-mcp-server
Claude Desktop / other MCP clients
Add to your MCP config:
{
"mcpServers": {
"expert-service": {
"command": "expert-mcp-server"
}
}
}
Or run from source:
{
"mcpServers": {
"expert-service": {
"command": "uvx",
"args": ["--from", "git+https://github.com/benthomasson/expert-mcp-server", "expert-mcp-server"]
}
}
}
Tools
| Tool | Description |
|---|---|
deep_search |
Dual-path retrieval across beliefs and source documents with IDF ranking. Sub-second, no LLM call. Start here. |
ask |
LLM-synthesized answer grounded in the knowledge base. |
search |
Full-text search across beliefs, entries, and source documents. |
explain_belief |
Trace why a belief is IN or OUT through its justification chain. |
what_if |
Simulate retracting or asserting a belief to see the cascade. |
get_belief |
Full details for a specific belief including justifications. |
list_beliefs |
List beliefs filtered by status (IN/OUT). |
list_projects |
List available expert knowledge bases. |
list_entries |
List analysis entries (reports, findings). |
get_entry |
Read the full content of an entry. |
All tools accept an optional project parameter. If omitted, the default project from config is used.
License
MIT
Install Expert Server in Claude Desktop, Claude Code & Cursor
unyly install expert-mcp-serverInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add expert-mcp-server -- uvx --from git+https://github.com/benthomasson/expert-mcp-server expert-mcp-serverFAQ
Is Expert Server MCP free?
Yes, Expert Server MCP is free — one-click install via Unyly at no cost.
Does Expert Server need an API key?
No, Expert Server runs without API keys or environment variables.
Is Expert Server hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install Expert Server in Claude Desktop, Claude Code or Cursor?
Open Expert Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare Expert Server with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
