io.github.prismatic-io/prism-mcp

@prismatic-io/prism-mcp

Prism MCP Server is a local Model Context Protocol (MCP) server that helps AI assistants work with the Prismatic API for code-native integration and custom component development.

[!NOTE] Prism now has MCP support built in! With Prism 11 or later, use prism --mcp to start the server. The standalone prism-mcp package is still available, but is deprecated in favor of this built-in support.

For help building and working with Prismatic from your coding assistant, check out Prismatic agent skills, the new home for our AI development guidance. Get started with npx skills add prismatic-io/agent-skills.

Features

This MCP server provides several tools, organized into categories. You may register whatever set of tools are most relevant to your use case.

General Tools (Always Available)

• prism_me: Check login status and display current user profile information
• prism_components_list: List all available components with version options

Integration Tools (Toolset: "integration")

Utilities

• prism_integrations_list: List all integrations
• prism_integrations_init: Initialize a new Code Native Integration
• prism_integrations_convert: Convert an existing Low-Code Integration to Code Native
• prism_integrations_flows_list: List flows for an integration
• prism_integrations_flows_test: Test a flow in an integration
• prism_integrations_flows_listen: Set a flow to "Listening Mode" to capture webhook payloads or polling trigger responses, saving them as payloads for prism_integrations_flows_test
• prism_integrations_import: Import an integration from a specific directory

Codegen

• prism_install_component_manifest: Generate component manifest in CNI src directory (requires spectral@10.6.0 or greater)
• prism_install_legacy_component_manifest: Generate line to add to a CNI's devDependencies for legacy component manifest installation
• prism_integrations_generate_flow: Generate boilerplate file for a CNI flow
• prism_integrations_generate_config_page: Generate boilerplate code for a CNI config page
• prism_integrations_generate_config_var: Generate boilerplate code for a config variable
• prism_integrations_add_connection_config_var: Returns path to connection wrapper function if available, otherwise generates boilerplate code for a connection config variable
• prism_integrations_add_datasource_config_var: Returns path to datasource wrapper function if available, otherwise generates boilerplate code for a datasource config variable

Component Tools (Toolset: "component")

• prism_components_init: Initialize a new Component (supports WSDL/OpenAPI generation)
• prism_components_publish: Publish a component from a specific directory
• prism_components_generate_manifest: Generate the manifest for a Prismatic component

Toolset Configuration

Tools are organized into toolsets, selected by passing their names as arguments after the working directory (see Command-line arguments):

• integration - Enables all integration-related tools
• component - Enables all component-related tools
• General tools are always available regardless of toolset configuration

If no toolset arguments are passed, all tools are registered by default. Naming an unrecognized toolset is a startup error.

Prerequisites

Authenticate with Prismatic. The server bundles its own pinned copy of the Prism CLI, so you don't need to install one for the server to use — but you do need to be logged in. Install the CLI to run the login command (it writes credentials to a shared config file the server reads automatically), or in headless/CI environments set PRISM_REFRESH_TOKEN instead.

npm install --global @prismatic-io/prism
prism login

Usage

Configuration

Configuration location and methods vary slightly depending on the AI tool you are using, but the following is relatively standard. More specific instructions are below.

Example setup:

{
  "mcpServers": {
    "prism": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@prismatic-io/prism-mcp", "."],
      "env": {
        "PRISMATIC_URL": "https://app.prismatic.io"
      }
    }
  }
}

If you would like the MCP server to run in a different directory than the currently open workspace, replace the . path argument with your working directory,

{
  "args": ["-y", "@prismatic-io/prism-mcp", "/path/to/code-native/integration"]
}

Command-line arguments:

• First argument: Required. Working directory path that determines where Prism CLI commands are run from. Most coding agents (like Cursor and Claude Code) will interpret . as the current workspace directory. If your coding agent does not support this, you can specify an absolute path of your code-native integration or custom component project instead.
• Remaining arguments: Optional. Toolsets to enable (integration, component). If no toolsets are specified, all tools are registered by default. Being selective about toolsets may improve performance. For example, to enable only integration-related tools:

  {
    "args": ["-y", "@prismatic-io/prism-mcp", ".", "integration"]
  }

Optional environment variable options:

• PRISMATIC_URL: https://app.prismatic.io by default. If your Prismatic tenant is hosted in a different region, or if you use a private stack deployment, set this variable to your Prismatic URL.
• MCP_PRISM_PATH: Absolute path to a specific Prism CLI to run instead of the bundled one (e.g. a locally built CLI). Must point at a regular file; otherwise the bundled CLI is used.

Installing with Claude Desktop

Add the above JSON config to your claude_desktop_config.json file.

Installing with Claude Code

To use this MCP server with Claude code, add the above config to your working directory's .mcp.json configuration file.

Alternatively, run

claude mcp add-json prism '{"type":"stdio","command":"npx","args":["-y","@prismatic-io/prism-mcp","."],"env":{"PRISMATIC_URL":"https://app.prismatic.io"}}'

Installing with Cursor

You can configure available MCP Servers via Cursor Settings > MCP Tools, then add the above config to your mcp.json file.

Or, click this link to install automatically: Add MCP Server to Cursor

Installing with VS Code / GitHub Copilot

Add the above config to the .vscode/mcp.json in your workspace, or the global mcp.json file (accessible via the "Add MCP Server..." option in the Command Palette).

Or, click this link to install automatically: Add MCP Server to VS Code

Other tools

If your agent of choice is not listed, please reference their official documentation for setup instructions.

What is Prismatic?

Prismatic is the leading embedded iPaaS, enabling B2B SaaS teams to ship product integrations faster and with less dev time. The only embedded iPaaS that empowers both developers and non-developers with tools for the complete integration lifecycle, Prismatic includes low-code and code-native building options, deployment and management tooling, and self-serve customer tools.

Prismatic's unparalleled versatility lets teams deliver any integration from simple to complex in one powerful platform. SaaS companies worldwide, from startups to Fortune 500s, trust Prismatic to help connect their products to the other products their customers use.

With Prismatic, you can:

• Build integrations using our intuitive low-code designer or code-native approach in your preferred IDE
• Leverage pre-built connectors for common integration tasks, or develop custom connectors using our TypeScript SDK
• Embed a native integration marketplace in your product for customer self-service
• Configure and deploy customer-specific integration instances with powerful configuration tools
• Support customers efficiently with comprehensive logging, monitoring, and alerting
• Run integrations in a secure, scalable infrastructure designed for B2B SaaS
• Customize the platform to fit your product, industry, and development workflows

Who uses Prismatic?

Prismatic is built for B2B software companies that need to provide integrations to their customers. Whether you're a growing SaaS startup or an established enterprise, Prismatic's platform scales with your integration needs.

Our platform is particularly powerful for teams serving specialized vertical markets. We provide the flexibility and tools to build exactly the integrations your customers need, regardless of the systems you're connecting to or how unique your integration requirements may be.

What kind of integrations can you build using Prismatic?

Prismatic supports integrations of any complexity - from simple data syncs to sophisticated, industry-specific solutions. Teams use it to build integrations between any type of system, whether modern SaaS or legacy with standard or custom protocols. Here are some example use cases:

• Connect your product with customers' ERPs, CRMs, and other business systems
• Process data from multiple sources with customer-specific transformation requirements
• Automate workflows with customizable triggers, actions, and schedules
• Handle complex authentication flows and data mapping scenarios

For information on the Prismatic platform, check out our website and docs.

License

This repository is MIT licensed.