# Fulcra

An MCP server that hands your agent tools for the Fulcra Context API. Useful when project context lives in Fulcra.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: fulcradynamics
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/fulcradynamics/fulcra-context-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/fulcra

## What it does

The server sits on top of the `fulcra-api` Python package and exposes tools plus resources that call Fulcra. It can run as a local stdio process or as a remote Streamable HTTP endpoint. A public instance is already up at `https://mcp.fulcradynamics.com/mcp`, so an OAuth2-capable MCP client is all you need to reach it.

OAuth2 is handled inside the server. It catches the callback itself and keeps exchanged tokens away from MCP clients, routing traffic through its own authorization service with a mapping table underneath.

Model-facing tools include `open_agent_contacts`, which opens Agents I Know, optionally aimed at an exact peer user ID or a discovered multiparty thread ID. Opening is read-only and rendering needs a host with MCP Apps support. Another is `update_data_type`: it renames or re-describes an owned active v1 Event/Metric type after user authorization, then reads it back independently. Schemas, records and shares stay untouched; a write you are unsure about needs reconciliation. For local runs, `uvx` is the shortest path.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.fulcradynamics.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http context https://mcp.fulcradynamics.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add fulcra -- uvx fulcra-context-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fulcra-context-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add fulcra --url https://mcp.fulcradynamics.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add fulcra -- uvx fulcra-context-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fulcra-context-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fulcra": {
            "url": "https://mcp.fulcradynamics.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fulcra": {
            "command": "uvx",
            "args": [
                "fulcra-context-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fulcra-context-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fulcra": {
            "type": "http",
            "url": "https://mcp.fulcradynamics.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fulcra": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "fulcra-context-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fulcra-context-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http fulcra https://mcp.fulcradynamics.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add fulcra uvx fulcra-context-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fulcra-context-mcp <command>

## When to use it
- list known agents and jump to a specific thread
- read Fulcra Context data from inside the agent
- rename or re-describe an owned Event/Metric type
- connect Fulcra to a client without handling tokens by hand
- run the server locally while working on it

## Example prompts
- Connect to Fulcra and list the agents I know
- Open `open_agent_contacts` for that user and show the thread
- Update the description on my active metric type and read it back

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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