toremlabs avatar

Heuresis

toremlabs/heuresis-mcp

Connects Claude to your Heuresis workspace through Supabase with the same RLS the web app uses. Ships 34 tools: read your concept graph, create and link nodes, run TRIZ/ASIT/C-K operators to generate design candidates, and commit results back to the cloud. Live sync over Supabase Realtime means edits in the web UI appear in your agent session without a refresh. One-time device login flow stores credentials locally. Useful when you want an LLM to navigate your idea graph, expand concepts recursively, or apply systematic innovation operators without leaving the chat window. The operator tools mirror the webapp's ideation engine, so Branch/Matrix/Contradiction runs produce the same candidate sets.

tools
34
transport
STDIO
last updated
Jun 2, 2026

Tools

34 tools

Public tool metadata for what this MCP can expose to an agent.

get_workspace_summaryMost agent sessions start with get_workspace_summary or list_projects.

Most agent sessions start with get_workspace_summary or list_projects.

No parameter schema in public metadata yet.

list_projectsMost agent sessions start with get_workspace_summary or list_projects.

Most agent sessions start with get_workspace_summary or list_projects.

No parameter schema in public metadata yet.

get_project_graph

No parameter schema in public metadata yet.

list_concepts

No parameter schema in public metadata yet.

list_edges

No parameter schema in public metadata yet.

get_subtree

No parameter schema in public metadata yet.

get_concept

No parameter schema in public metadata yet.

search_concepts

No parameter schema in public metadata yet.

find_concepts

No parameter schema in public metadata yet.

list_recent_decisions

No parameter schema in public metadata yet.

add_concept

No parameter schema in public metadata yet.

update_concept

No parameter schema in public metadata yet.

bulk_add_concepts

No parameter schema in public metadata yet.

set_parent

No parameter schema in public metadata yet.

validate_concept

No parameter schema in public metadata yet.

set_standing

No parameter schema in public metadata yet.

archive_concept

No parameter schema in public metadata yet.

unarchive_concept

No parameter schema in public metadata yet.

star_concept

No parameter schema in public metadata yet.

remove_concept

No parameter schema in public metadata yet.

link_concepts

No parameter schema in public metadata yet.

add_kref

No parameter schema in public metadata yet.

create_idea

No parameter schema in public metadata yet.

rename_idea

No parameter schema in public metadata yet.

recolor_idea

No parameter schema in public metadata yet.

set_idea_members

No parameter schema in public metadata yet.

add_to_idea

No parameter schema in public metadata yet.

delete_idea

No parameter schema in public metadata yet.

create_project

No parameter schema in public metadata yet.

update_project

No parameter schema in public metadata yet.

delete_project

No parameter schema in public metadata yet.

run_operatorGenerate candidates with Branch / Matrix / ASIT / TRIZ / Combine / Free / Contradiction.

Generate candidates with Branch / Matrix / ASIT / TRIZ / Combine / Free / Contradiction.

No parameter schema in public metadata yet.

run_operator_and_commitSame as run_operator, plus commit the result in one round-trip.

Same as run_operator, plus commit the result in one round-trip.

No parameter schema in public metadata yet.

expand_conceptRecursive Branch, capped at depth × breadth ≤ 60.

Recursive Branch, capped at depth × breadth ≤ 60.

No parameter schema in public metadata yet.

Sponsors

Readme

@heuresis/mcp

A Model Context Protocol (MCP) server that exposes a Heuresis workspace to any MCP-capable client (Claude Desktop, Claude Code, Cursor, Windsurf, custom agents). The server logs into the user's Heuresis account, talks to the same Supabase project the webapp talks to, and respects the same RLS. Webapp and MCP are two front-ends to one cloud workspace.

Current version: 1.0.0-rc.13.

Install

npm install -g @heuresis/mcp
# or on demand without installing:
npx -y @heuresis/mcp

Package name vs. command name. The npm package is @heuresis/mcp; the command it installs is heuresis-mcp. A bare npx -y @heuresis/mcp (no subcommand) starts the MCP server fine, but npx @heuresis/mcp login can fail with heuresis-mcp: not found because npx derives the command name from the scope-stripped package name (mcp), which doesn't match. To run a subcommand reliably on every npm/OS, name the binary explicitly with -p:

npx -y -p @heuresis/mcp heuresis-mcp login

Quickstart

1. Link this machine to your Heuresis account

npx -y -p @heuresis/mcp heuresis-mcp login

View the full README on GitHub

Details

Repository
github.com/toremlabs/heuresis-mcp
Package
@heuresis/mcp
Transport
STDIO
Registry
MCP registry, active