MCP Server

Create and manage architecture diagrams from Claude Code, Cursor, Windsurf, or any MCP-compatible client.

Claude Code Cursor Windsurf Any MCP client

Setup

1 Get your API key

Sign in at netfilia.app, open AI Settings (top-right menu), and click Generate MCP Key. The key starts with nf_ and is shown only once — copy it.

2 Install the MCP server

No global install needed. npx downloads and runs it on demand:

terminal

      npx -y netfilia-mcp

3 Add to your client config

Claude Code — add to ~/.claude.json:

~/.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:

Cursor MCP config

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

Windsurf / other MCP clients — same format, consult your client's MCP documentation for the config file location.

💡 Tip: You can also set NETFILIA_SCHEMA_ID to auto-target a specific schema without passing it to every tool call.

Available tools

The MCP server exposes 21 tools organized in 5 groups:

Schemas

Tool	Description
`list_schemas`	List all your schemas
`get_schema`	Get full schema by ID
`create_schema`	Create a new empty schema
`update_schema`	Update title or data
`delete_schema`	Permanently delete a schema

Objects (nodes)

Tool	Description
`create_object`	Add a node (server, switch, firewall, etc.)
`list_objects`	List objects in a schema
`get_object`	Get object details
`update_object`	Update properties (name, type, group, tags)
`delete_object`	Remove an object (cascades connections)

Connectors (interfaces)

Tool	Description
`add_connector`	Add a network interface (IP, VLAN, subnet)
`update_connector`	Update interface properties
`delete_connector`	Remove an interface

Connections (edges)

Tool	Description
`create_connection`	Draw a link between two objects
`get_connection`	Get connection details
`update_connection`	Update label, style, direction
`delete_connection`	Remove a connection

Utilities

Tool	Description
`validate_schema`	Check against validation rules
`get_summary`	Counts by type, connections, subnets

Authentication

Two methods supported:

Method	Format	Expiration	How to get
MCP API key (recommended)	`nf_` + 64 hex chars	Never (revocable)	AI Settings → Generate MCP Key
JWT	Bearer token	7 days	POST /api/auth/login

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

Examples

Once connected, ask your AI naturally:

Claude Code
# Create a schema from scratch
> Create a web stack with a load balancer, 2 web servers, and a Postgres database

# Add to an existing schema
> Add a Redis cache between the web servers and the database

# Check your work
> Validate the schema and show me the summary

# Manage schemas
> List my schemas
> Delete the schema called "test"

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 use this if no schemaId is passed

Troubleshooting

Server not showing in MCP list

Restart your AI IDE after editing the config file. MCP servers are loaded at startup.

"NETFILIA_API_URL is not set"

Check that your config has the env block with both NETFILIA_API_URL and NETFILIA_TOKEN.

"401 Unauthorized"

Your API key may be invalid or revoked. Generate a new one in AI Settings.

"Connection refused"

Verify NETFILIA_API_URL is correct (https://netfilia.app). No trailing slash.

npm package

npmjs.com/package/netfilia-mcp