# Biel.ai

Biel.ai is an MCP server for Claude Code that searches indexed documentation and returns source links. It connects an AI client to a Biel.ai project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: TechDocsStudio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TechDocsStudio/biel-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bielai

## What it does

Biel.ai gives an AI client access to documentation indexed in a Biel.ai project. It can search for relevant passages, fetch the full text of a returned document, or produce an answer with conversation context. The server exposes `biel_search`, `biel_get_document`, and `biel_ai`.

A Biel.ai account, indexed sources, and hosted MCP enabled on an eligible plan are required. Private projects need an API key with `search` permission for retrieval; generated answers also require `chats_create`. Refresh the project sources after documentation changes so later searches use the updated index.

Self-hosting uses Python 3.10 or newer and the official Python MCP SDK 2.3. The standalone default keeps session and conversation state in memory, so a restart removes those conversations.

## Requirements
- Remote server: `https://mcp.biel.ai/v2/{project_slug}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http biel-ai https://mcp.biel.ai/v2/{project_slug}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add bielai --url https://mcp.biel.ai/v2/{project_slug}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bielai": {
            "url": "https://mcp.biel.ai/v2/{project_slug}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bielai": {
            "type": "http",
            "url": "https://mcp.biel.ai/v2/{project_slug}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http bielai https://mcp.biel.ai/v2/{project_slug}/mcp
```

## When to use it
- search indexed documentation for API instructions
- read a complete document from its `document_id`
- generate an answer with links to supporting sources
- continue a conversation with `conversation_id`

## Example prompts
- Use `biel_search` to find the API authentication instructions and explain the required headers.
- Use `biel_get_document` with the returned `document_id` and summarize the document requirements.
- Use `biel_ai` to answer how to rotate a credential, continuing the earlier conversation.

## Similar
- [context7-mcp](https://affpapa.org/en/nevibecode/skills/context7-mcp.md) — skill · 7200 installs
- [stripe-docs](https://affpapa.org/en/nevibecode/skills/stripe-stripe-docs.md) — skill · 2900 installs
- [twitterapi-io-mcp](https://affpapa.org/en/nevibecode/mcp/twitterapi-io-mcp.md) — MCP server · ★ 10 repo stars
- [convex-docs](https://affpapa.org/en/nevibecode/skills/convex-docs.md) — skill · 44100 installs
- [documenting-contracts](https://affpapa.org/en/nevibecode/skills/documenting-contracts.md) — skill · 26300 installs
- [reef](https://affpapa.org/en/nevibecode/plugins/reef.md) — plugin · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
