AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Flowscript

mcp-phillipclapham-flowscript · by phillipclapham

Queryable reasoning memory for AI agents. Six typed queries (why, tensions, blocked, whatIf, alternatives, counterfactual) over reasoning graphs. Vector stores remember what. FlowScript remembers why. TypeScript SDK + MCP server.

↗ Website ↗ Repository
— No reviews yet
0 installs
8 views
0.0% view→install

Install

$ agentstack add mcp-phillipclapham-flowscript

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-phillipclapham-flowscript)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
○ Archived

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Flowscript? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

FlowScript

Semantic notation for structured reasoning

21 typed markers for encoding decisions, tensions, blockers, causal chains, and temporal knowledge.

> Evolution note: FlowScript explored typed reasoning representation for AI agents — compression-as-cognition, temporal graduation, citation-validated patterns, immune system. These core concepts evolved into anneal-memory, a two-layer memory system for AI agents. The notation remains in active daily use for reasoning compression and knowledge encoding. This repo is maintained as a reference implementation and notation playground.

The Notation

FlowScript is a 21-marker semantic notation that both humans and AI parse natively. It sits between natural language (ambiguous, verbose) and formal logic (precise, unreadable). Start with three markers — ->, `> sub-ms reads, proven at scale || PostgreSQL -> rich queries, $15/month, ACID

speed >

  • CodeMirror 6 with custom FlowScript language mode and syntax highlighting
  • D3 force-directed graph visualization of reasoning nodes and relationships
  • Live query panel — run tensions(), blocked(), why() against your graph in the browser
  • WCAG AA accessible, responsive design

Source code in [web/](web/).

Notation Spec

The full FlowScript v2.1 specification in [spec/](spec/):

  • semantics.md — all 21 markers formally defined
  • grammar.md — EBNF formal grammar
  • ir.schema.json — JSON schema for the intermediate representation
  • linter-rules.md — semantic validation rules (6 errors, 3 warnings)

Teaching Materials

  • [FLOWSCRIPT_SYNTAX.md](FLOWSCRIPT_SYNTAX.md) — comprehensive syntax reference with examples
  • [FLOWSCRIPT_LEARNING.md](FLOWSCRIPT_LEARNING.md) — conceptual introduction
  • [FLOWSCRIPT_EXAMPLES.md](FLOWSCRIPT_EXAMPLES.md) — real-world patterns (before/after)
  • [ADVANCED_PATTERNS.md](ADVANCED_PATTERNS.md) — recursive nesting, meta-thoughts, metaprogramming
  • [examples/](examples/) — four golden examples (Decision, Debug, Research, Design) with teaching guides

What Evolved into anneal-memory

Through building FlowScript, we discovered that the core insights were more powerful than the syntax:

| FlowScript explored | anneal-memory delivers | |:---------------------|:----------------------| | Temporal graduation (1x → 2x → 3x → proven) | Citation-validated graduation with immune system | | Compression-as-cognition | Episodes compress into identity through consolidation | | Hash-chained audit trail | Tamper-evident compliance layer (EU AI Act) | | Anti-inbreeding defense | Graduation gate + principle demotion through citation decay | | Transport-layer wrapper | Compliance proxy vision (MCP transport interception) | | Six typed reasoning queries | Planned for anneal-memory CLI |

The notation barrier was real — developers won't learn a new syntax for memory. anneal-memory delivers the same cognitive architecture as a zero-dependency MCP server where agents use natural language.

anneal-memory on GitHub | anneal-memory on PyPI

Related

Built by Phill Clapham · Clapham Digital LLC

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in AI & ML