Prism

Prism

Multi-server MCP tool bridge — expose banking, email, calendar, and custom API tools over the Model Context Protocol.

Prism lets you define multiple servers, each with its own bearer token and set of profiles. AI clients (Cursor, Claude Desktop, etc.) connect to a server's MCP endpoint and get access to only the tools and profiles that server is configured for.

Architecture

┌─────────────┐     ┌─────────────┐
│  AI Client   │     │  AI Client   │
│  (Cursor)    │     │  (Claude)    │
└──────┬───────┘     └──────┬───────┘
       │ Bearer A           │ Bearer B
       ▼                    ▼
┌──────────────────────────────────┐
│            Prism                 │
│  /mcp/server-a  /mcp/server-b   │
│  ┌──────────┐   ┌──────────┐    │
│  │ 9 accts  │   │ 3 accts  │    │
│  │ 17 tools │   │ 11 tools │    │
│  └──────────┘   └──────────┘    │
└────┬────┬────┬────┬─────────────┘
     │    │    │    │
     ▼    ▼    ▼    ▼
   bunq  IMAP  Cal  Cyans

Each server exposes the same tool types but scoped to its own profiles. A personal server sees all your email profiles; a shared server only sees the shared mailbox.

Tools (24)

| Category | Tool | Description | |---|---|---| | bunq | bunq_list_profiles | List configured bank profiles | | | bunq_list_transactions | List transactions with date/amount filters | | | bunq_get_transaction | Get full transaction details | | | bunq_get_transaction_notes | Get notes and attachments on a transaction | | Email | email_list_profiles | List configured email profiles | | | email_list_folders | List mailbox folders with unread counts | | | email_create_folder | Create a new IMAP folder (errors if it already exists) | | | email_list_labels | List folders and custom IMAP keyword tags | | | email_search | Search emails by sender, subject, date, flags (excludes soft-deleted by default) | | | email_get_messages | Fetch one or many messages (same-folder or folder+uid combos) | | | email_get_message_labels | Read flags and custom keyword tags on a message | | | email_update_message_flags | Set/clear flags and add/remove keyword tags | | | email_send | Send a new message or reply (markdown, threaded, saved to Sent) | | | email_create_draft | Stage a draft in IMAP Drafts (never sends; optional reply threading) | | | email_delete_draft | Permanently delete a staged draft from Drafts | | Calendar | calendar_list_calendars | List configured ICS calendars | | | calendar_list_events | List upcoming events with date range filter | | | calendar_get_event | Get event details by UID | | Cyans | cyans_get_open_topics | Get open topics for a user | | | cyans_get_topic_details | Get full topic with posts | | | cyans_search_topics | Search topics by subject | | | cyans_add_post | Add a post to a topic | | Picnic | picnic_list_profiles | List configured Picnic profiles | | | picnic_search_products | Search grocery products by name | | | picnic_get_cart | Get the current shopping cart | | | picnic_add_to_cart | Add a product to the cart | | | picnic_remove_from_cart | Remove a product from the cart | | | picnic_list_deliveries | List past and upcoming deliveries (optional state filter) | | | picnic_get_delivery | Get full details of a single delivery | | Utility | day_name | Get day-of-week for a date | | | sum | Sum an array of numbers |

Quick Start

1. Clone and install

git clone https://github.com/YOUR_ORG/prism.git
cd prism
composer install
npm install && npx encore dev

2. Configure

Copy the example config and edit it:

cp prism.config.yaml.example prism.config.yaml

servers:
  my-server:
    label: "My Personal Server"
    bearer_token: "generate-a-random-token"
    profiles:
      my-email:
        type: email
        label: "Personal Email"
        imap:
          host: "imap.example.com"
          port: 993
          encryption: ssl
          username: "me@example.com"
          password: "app-password"
          validate_cert: true
        smtp:
          host: "smtp.example.com"
          port: 465
          encryption: ssl
        identity:
          email: "user@example.com"
          name: "Example User"
      my-picnic:
        type: picnic
        label: "Picnic NL"
        username: "me@example.com"
        password: "your-picnic-password"
        country_code: "nl"

Set admin credentials:

# .env.local
APP_AUTH_USER=admin
APP_AUTH_PASSWORD=a-secure-password

3. Run with Docker

docker compose up -d

The app is served via Traefik. Configure the hostname in docker-compose.yml.

4. Connect your AI client

Add to your Cursor .mcp.json:

{
  "mcpServers": {
    "prism": {
      "url": "https://your-host/mcp/my-server",
      "headers": {
        "Authorization": "Bearer generate-a-random-token"
      }
    }
  }
}

Admin UI

Prism includes a built-in admin dashboard at /admin with:

• Server list — overview of all configured servers with profile/tool counts
• Configuration tab — connection details and .mcp.json snippet
• Profiles tab — profiles grouped by type
• Tools tab — all available tools for the server, linking to detail pages
• Tool detail — input schema, parameters table, and an interactive Try It panel for executing tools with YAML input/output

Each tab and tool detail page has its own URL for bookmarking.

Profile Types

| Type | Config Keys | What It Connects To | |---|---|---| | bunq | api_key, environment, monetary_account_id | bunq banking API | | email | imap., smtp., identity.* | Any IMAP mailbox + SMTP relay (read, search, send, save-to-Sent) | | calendar | ics_url, summary | Any ICS/iCal feed (Google Calendar, etc.) | | cyans | dsn, username | Cyans topic tracking API | | picnic | username, password, country_code | Picnic grocery delivery (unofficial API) | | instagram | ig_user_id, access_token, app_id, app_secret | Instagram Graph API — profile, insights, comments, hashtag search, business discovery, publishing (see docs/instagram.md) |

Tech Stack

• PHP 8.2+ / Symfony 7.2
• Tailwind CSS via Webpack Encore
• Docker with Traefik reverse proxy
• MCP Protocol v2024-11-05 (JSON-RPC over HTTP with Bearer auth)

License

MIT