Skip to content
MCP server

Idf MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.2
Listing updated
5 days ago

About Idf MCP

Idf MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • IDF_SERVERBase URL of the IDF host runtime (e.g. http://localhost:3001).Required
  • IDF_DOMAINIDF domain to expose as MCP tools (e.g. invest, booking, planning).Required
  • IDF_BOOTSTRAPSet to 0 if the host runtime already bootstrapped the domain; 1 (default) to bootstrap from IDF_ONTOLOGY_PATH on first connection.
  • IDF_ONTOLOGY_PATHFilesystem path to the domain ontology module (only used when IDF_BOOTSTRAP=1).
  • IDF_AUTH_TOKENOptional bearer token forwarded to the host runtime as the agent's role credential.

Pricing

Open source

Idf MCP 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.

How AIPoweredBot checks servers