# Frisian MCP (Django)

Exposes Django REST Framework ViewSets as MCP tools with automatic schema discovery. It connects coding agents to your API while keeping token usage low.

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

## What it does

Frisian MCP inspects Django route patterns and registers discovered ViewSets as tools on the fly. Parameter structures, descriptions, and validations come straight from DRF serializers. Standard backend filters like `SearchFilter` and `OrderingFilter` automatically translate into tool input arguments.

The server addresses prompt window exhaustion through dispatchers. While regular flat registrations dump hundreds of separate schemas into context, `FRISIAN_MCP_DISPATCH_GROUPS` consolidates actions under single dispatcher tools. Bulk operations return a fixed 24-token response envelope rather than echoing back entire payload objects.

Running this gateway requires Python 3.11+, Django 5.x, and Django REST Framework 3.14 or newer. Host application throttles, queryset filtering, and authentication rules stay enforced on every call.

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

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http django https://mcp.frisian-mcp.com/mcp/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add frisian-mcp-django --url https://mcp.frisian-mcp.com/mcp/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frisian-mcp-django": {
            "url": "https://mcp.frisian-mcp.com/mcp/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frisian-mcp-django": {
            "type": "http",
            "url": "https://mcp.frisian-mcp.com/mcp/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http frisian-mcp-django https://mcp.frisian-mcp.com/mcp/
```

## When to use it
- expose Django REST Framework endpoints to coding agents
- reduce context token consumption using tool dispatchers
- prevent context window bloat during bulk write operations
- enforce Django permissions and rate limits on agent calls

## Example prompts
- Inspect the available tools using the dispatcher action="help"
- Verify the gateway configuration by running python manage.py mcp_doctor
- Fetch the list of records through the users.list tool

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

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