mcp-flowcore-platform

This MCP server exposes the Flowcore Platform via the Model Context Protocol, allowing AI assistants and automation to query, manage, and interact with Flowcore resources through a standardized API. The server is accessed by running the package with npx (no local install required) and providing your Flowcore credentials. Once running, you can issue MCP queries and commands against the Flowcore Platform endpoints supported by the server, enabling programmatic access to resources, configurations, and state.

To use it, run the server with your Flowcore username and Personal Access Token (PAT) as environment values or command-line inputs. Typical usage is through npx, which pulls the latest package version and starts the MCP interface. After starting, you can integrate this MCP server with your AI tooling or chat assistants to perform actions such as listing resources, querying metadata, and executing platform operations via MCP-compliant requests. For local testing or development, you can also explore the related local read model MCP server mentioned in the repository to compare capabilities and performance.

Prerequisites:

• Node.js installed (npx is included with npm/Yarn).
• internet access to fetch the package from npm registry.

Option A: Run without installing (npx)

1. Ensure Node.js is installed.
2. Run:

npx @flowcore/platform-mcp-server --username <username> --pat <pat>

3. The MCP server starts and awaits requests using your provided credentials.

Option B: Install globally

1. Ensure Node.js is installed.
2. Install the package globally:

npm install -g @flowcore/platform-mcp-server

3. Run the server:

platform-mcp-server --username <username> --pat <pat>

Option C: Development workflow (optional)

1. Install Bun (for development steps in the repository):

bun install

2. Run directly with Bun (for development):

bun run src/index.ts --username <username> --pat <pat>

3. Build and run the built project (if applicable):

bun run build
node dist/cli.js --username <username> --pat <pat>

Environment variables: USERNAME and PAT are required. These correspond to your Flowcore username and Personal Access Token. If you encounter authentication issues, double-check that your PAT has the necessary scopes for MCP interactions. The server is designed to be used with MCP-compliant clients; ensure your client sends properly structured MCP requests. If you’re experimenting locally, you can reference the repository’s guidance to use the local read model MCP server for comparison and potential latency improvements. For troubleshooting, verify Node.js and npm versions, network access to npm, and that the environment variables are correctly set in your execution environment.