Graph Builder MCP

☁️ Graph Builder MCP

The Graph Builder MCP server gives AI agents the tools to create, validate, and explore Actionforge graphs. It connects to the Actionforge knowledge base for node search, documentation lookup, and example graph retrieval.

Describe what you want in natural language and let your AI assistant create, test, and iterate on action graphs for you. While an agent is editing a graph, the editor marks the file as locked and shows which agent is currently working on it.

Claude Code

❯ Build me an Unreal Engine CI pipeline that compiles, cooks, and packages a Windows build

  ▪ search_nodes "unreal build"
  ▪ validate_graph
  ○ Editing ue5-win-shipping.act

· Shenaniganing…
────────────────────────────────────────────────────────────────────────────────────────────────────
⏵⏵ accept edits on (shift+tab to cycle)2 mcp servers active

Endpoint: https://app.actionforge.dev/api/v2/mcp

No authentication required.

Configuration

Claude Code

claude mcp add --transport http actionforge https://app.actionforge.dev/api/v2/mcp

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "actionforge": {
      "url": "https://app.actionforge.dev/api/v2/mcp"
    }
  }
}

GitHub Copilot

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "actionforge": {
      "type": "http",
      "url": "https://app.actionforge.dev/api/v2/mcp"
    }
  }
}

OpenCode

Add to opencode.json in your project:

{
  "mcp": {
    "actionforge": {
      "type": "remote",
      "url": "https://app.actionforge.dev/api/v2/mcp"
    }
  }
}

Windsurf

Add to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "actionforge": {
      "url": "https://app.actionforge.dev/api/v2/mcp"
    }
  }
}

Available Tools

Tool	Description
build_node	List available node types or scaffold a skeleton graph from node type IDs
validate_schema	Validate a node (YAML or JSON) against the built-in schema
get_graph_schema	Full JSON schema for .act graph files
search_nodes	Search available node types by keyword or category
describe_node	Detailed documentation for a specific node type (built-in and GitHub Actions)
get_node_schema	Full JSON schema definitions for specific node types
get_port_types	Port data types and connection rules
validate_graph	Validate a complete graph structure (nodes, connections, executions)
search_graph_examples	Find example graphs and recommended nodes for a task description
search_documentation	Search the Actionforge knowledge base — CLI docs, API references, general docs
resolve_github_action	Resolve a GitHub Action URI into an Actionforge graph node
get_actionforge_runner_info	Get the latest actionforge/action runner version and workflow template

Typical Workflow

1. search_nodes to find relevant built-in nodes
2. search_documentation to find docs for GitHub, DCC tools, CLI commands
3. describe_node or get_node_schema for detailed port/type info
4. search_graph_examples to find reference graph patterns
5. get_graph_schema + get_port_types to understand the .act format
6. build_node to scaffold, then validate_graph to verify

File Locking Protocol

When modifying an existing .act file, agents must follow the locking protocol:

1. Add locked_by: <agent> as the first line before making changes
2. Make modifications
3. Remove the locked_by line after all changes are complete and validated

The graph editor shows which agent currently holds the lock. If a file is locked by a different agent, do not modify it.