X OpenAPI Flow MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/tiago-marques-x-openapi-flow-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

3 read · 1 write · 0 delete · 3 not yet classified

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (7)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• analyze

  Analyze a base OpenAPI file and infer a suggested sidecar (.x.yaml) with lifecycle states and transitions. Returns the inferred sidecar structure and analysis metadata. Use this to bootstrap sidecar authoring before an AI refines it manually.

• diff

  Compute the lifecycle diff between a base OpenAPI file and a sidecar file (.x.yaml/json). Returns added, changed, and removed operations with before/after flow metadata. Use before apply to review what changes will be merged.

• export_llm_flows

  Export a machine-oriented flow contract for coding agents implementing an integration against this API — NOT human documentation. Returns, per resource: initial/terminal states, entry-point operations, and for each operation its method/path/path params plus the full authored transitions (trigger_type, target_state, decision_rule, evidence_refs, prerequisite_operation_ids, prerequisite_field_refs, propagated_field_refs, failure_paths, compensation_operation_id, async_contract). Use this before writing integration code against a flow-annotated API, alongside the base OpenAPI file for request/res…

• graph

  Generate a Mermaid stateDiagram-v2 diagram of the lifecycle state machine from an OpenAPI flow file. Returns the mermaid block suitable for embedding in docs or visualizing in any Mermaid-compatible viewer.

• lint

  Run structural lint rules on an OpenAPI flow file. Checks: duplicate operationIds, invalid next_operation_id references, invalid prerequisite_operation_ids, duplicate transitions, non-terminating states. Returns issues grouped by rule with per-issue detail.

• quality_report

  Run the lifecycle quality report on an OpenAPI flow file. Returns a structured score (0–100), grade (A–F), and breakdown by quality dimension: completeness, field_coverage, semantic_depth, graph_soundness. Use to track lifecycle documentation maturity before release.

• validate

  Validate an OpenAPI flow file against the x-openapi-flow schema and lifecycle rules. Returns a structured result with ok status, errors by category (schema, orphan states, unreachable states, cycles, invalid refs, quality), quality score, and grade. Use profile 'strict' for release gates and CI.

Signals

Stars

6

Forks

0

Open issues

7

Last commit (this folder)

Sep 15, 2026 (1 month ago)

Last release

Sep 15, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.tiago-marques/x-openapi-flow-mcp

Version

1.7.4

Auth

No auth

Packages

npm x-openapi-flow

License

MIT

Repository

github.com/tiago-marques/x-openapi-flow

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql