netfilia-mcp

MCP server for Netfilia — create, edit, and manage architecture diagrams from Claude Code, Cursor, Windsurf, or any MCP-compatible client.

Quick start

1. Get your API key

Sign in at netfilia.app, go to AI Settings, and generate an MCP API key. It starts with nf_ and is shown only once — copy it.

2. Add to your MCP config

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "netfilia": {
      "command": "npx",
      "args": ["-y", "netfilia-mcp"],
      "env": {
        "NETFILIA_API_URL": "https://netfilia.app",
        "NETFILIA_TOKEN": "nf_your_key_here"
      }
    }
  }
}

Cursor (Settings → MCP Servers → Add):

{
  "command": "npx",
  "args": ["-y", "netfilia-mcp"],
  "env": {
    "NETFILIA_API_URL": "https://netfilia.app",
    "NETFILIA_TOKEN": "nf_your_key_here"
  }
}

3. Use it

Ask your AI to create diagrams:

> Create a web stack with a load balancer, 2 web servers, and a Postgres database
> Add a firewall in front of the load balancer
> Show me the current schema summary
> Validate the schema

Environment variables

| Variable | Required | Description | |---|---|---| | NETFILIA_API_URL | Yes | Base URL (e.g. https://netfilia.app) | | NETFILIA_TOKEN | Yes | MCP API key (nf_...) or JWT | | NETFILIA_SCHEMA_ID | No | Default schema ID (tools can override) |

Available tools

Schemas

• list_schemas — List all your schemas
• get_schema — Get a schema by ID
• create_schema — Create a new schema
• update_schema — Update title or data
• delete_schema — Delete a schema

Objects (nodes)

• create_object — Add a node (server, switch, firewall, etc.)
• list_objects — List objects in a schema
• get_object — Get object details
• update_object — Update object properties
• delete_object — Remove an object (cascades connections)

Connectors (interfaces)

• add_connector — Add a network interface to an object
• update_connector — Update interface properties (IP, VLAN, subnet)
• delete_connector — Remove an interface

Connections (edges)

• create_connection — Draw a link between two objects
• get_connection — Get connection details
• update_connection — Update connection properties
• delete_connection — Remove a connection

Utilities

• validate_schema — Check schema against validation rules
• get_summary — Object counts by type, connection count, subnet usage

Auth

The MCP server supports two authentication methods:

• MCP API key (recommended): Generate in AI Settings. Format: nf_ + 64 hex chars. No expiration, revocable.
• JWT: Short-lived token from login. Expires after 7 days.

When NETFILIA_TOKEN starts with nf_, the server uses x-api-key header. Otherwise, it uses Authorization: Bearer.

Links

• Website: netfilia.app
• Getting started: netfilia.app/beta.html

License

MIT