# Idf MCP

> Idf MCP is an open-source MCP server. Turn an IDF domain into an MCP server with invariants and role scopes in every tool description. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/intent-driven-software/idf-mcp
- **MCP Registry name:** io.github.intent-driven-software/idf-mcp
- **Listing updated:** 2026-11-13

## About

Turn an IDF domain into an MCP server with invariants and role scopes in every tool description.

## Install

### Claude Code (Terminal)

```sh
claude mcp add idf-mcp --env IDF_SERVER='<IDF_SERVER>' --env IDF_DOMAIN='<IDF_DOMAIN>' --env IDF_AUTH_TOKEN='<IDF_AUTH_TOKEN>' -- npx -y @intent-driven/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<IDF_SERVER>",
        "IDF_DOMAIN": "<IDF_DOMAIN>",
        "IDF_AUTH_TOKEN": "<IDF_AUTH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<IDF_SERVER>",
        "IDF_DOMAIN": "<IDF_DOMAIN>",
        "IDF_AUTH_TOKEN": "<IDF_AUTH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "idf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<IDF_SERVER>",
        "IDF_DOMAIN": "<IDF_DOMAIN>",
        "IDF_AUTH_TOKEN": "<IDF_AUTH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<IDF_SERVER>",
        "IDF_DOMAIN": "<IDF_DOMAIN>",
        "IDF_AUTH_TOKEN": "<IDF_AUTH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<IDF_SERVER>",
        "IDF_DOMAIN": "<IDF_DOMAIN>",
        "IDF_AUTH_TOKEN": "<IDF_AUTH_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is Idf MCP free?

Yes. Idf MCP is open source, so you can use and self-host it for free.

### How do I add Idf MCP to Claude Code?

Run this command in your terminal: claude mcp add idf-mcp --env IDF_SERVER='<IDF_SERVER>' --env IDF_DOMAIN='<IDF_DOMAIN>' --env IDF_AUTH_TOKEN='<IDF_AUTH_TOKEN>' -- npx -y @intent-driven/mcp-server

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/idf-mcp
