# MCP Server (Reference & FAQs) The Molecule MCP server exposes your Molecule data as a set of read-only tools that your AI assistant can call on your behalf. You interact with these tools through natural language — you never need to know the tool names directly. {% hint style="info" %} Molecule is the first ETRM to offer this feature to all of our customers, globally. It is in beta, so * Features may change during the beta period * Some tools may not yet be available or may have limitations * We welcome feedback — contact your Customer Success Manager or email The core data access is production-grade, but the AI interaction layer is evolving rapidly. {% endhint %} ## Using it {% hint style="success" %} The MCP server works with most LLMs. **It works best, by far, with Anthropic's Claude**. It provides richer answers, graphics, and more. OpenAI's ChatGPT works as well, but provides textual answers — and questions must address Molecule specifically. {% endhint %} In your LLM, you can now ask questions about your positions, today's P\&L and/or greeks, and market data. Use Molecule ticker symbols and as-of dates as a reference. Try: * "can you show me my positions from yesterday?" * (or, in ChatGPT: "can you show my my positions in Molecule from yesterday?") * if it asks you to narrow things down, try "book: #west" or "counterparty: NYMEX" * "can you compare December 9 vs 10?" * "what part of my book drove the most P\&L yesterday?" * "what was my theta decay risk?" * "can you show me the surface for LN and how it changed during the week prior to its expiry on December 23?" * can you give me the LN price surface on December 22? {% hint style="warning" %} **Always sense-check and/or verify critical figures.** The AI may round, summarise, or interpret data, even though Molecule sends accurate data. Cross-check important numbers in the Molecule UI before making trading decisions or reporting to counterparties. {% endhint %} ### Under the Hood: Tools An MCP server exposes "tools" to an LLM — these are things that the AI can call on your behalf to retrieve data from Molecule. We launched with two tools and are planning to add more, quickly. You don't have to reference a "tool" — the LLM will figure it out based on what our MCP server says about the tools we make available. In Claude, you don't even have to reference Molecule usually. In ChatGPT, you should reference Molecule explicitly. #### Positions `get_positions` retrieves your current open positions, with optional filtering by book, account, asset, or date. Uses Valuations/Summary under the hood to limit row count, and the [column groups](https://app.molecule.io/api/v2/valuations-2#include-options) `default, option` to limit column width for the LLM. Example prompts: * "Show me today's positions." * "What drove my MTM change between \ and \?" Note that the dates should be adjacent because the tool doesn't currently contemplate things realizing in between two dates. The tool can process non-adjacent dates but some things might not be captured. * "What part of my portfolio in Molecule is most exposed to theta?" * As a follow-up — "what might be happening in the market that drove this change?" {% hint style="info" %} Note that as of the first release, this tool limits returned rows to 500, to ensure compatibility with i.e., ChatGPT. So it may ask you to refine your portfolio (i.e., by book or counterparty) such that it can return you a full dataset. We will continue optimizing this; the goal being to return a full dataset with a query. {% endhint %} #### Marks `get_marks` retrieves market prices, forward curves, and volatility surfaces. Example prompts: * "What is the current TTF front-month price?" * "Show me the NBP forward curve." * "How has February 2027 NG moved over the last 5 days?" ## Turning it On ### Permissions Molecule has multiple flags to turn on the MCP server. The ones visible to you are: 1. Account-level MCP Server flag accessible only to Organizational Admins (at Mirage -> Account Settings -> Access Control) — `default: off` 2. User-level (or group-level) flag within an account — `default: on` All this boils down to: once your Organizational Admin turns the feature on and configures it (presumably with your IT team) — you should be able to connect via your LLM. ### Connecting To connect your LLM to the MCP server, contact your IT team to help you get started. They will need to do some things on their end. Once they do, you can add Molecule as a "Connector" in your LLM. You'll have to authenticate using your regular Molecule credentials, and you should be good to go. #### The Short Version 1. Enable the MCP Server in Molecule. * Have your Organizational Admin, or anyone with that permission, go to Mirage -> Account Settings -> Access Control and enable the MCP Server. 2. Add the Molecule MCP Server in your LLM workspace. * Have your LLM admin create a new custom MCP connection. * Use one of these URLs: * `https://mcp.eu.molecule.io` — Europe Production * `https://mcp.app.molecule.io` — US Production 3. Connect each user account. * Have each user open the LLM's settings and connect their Molecule account. {% hint style="info" %} The full IT guide is with our API docs, at: . Ask our support team for the password, if you don't have it. {% endhint %} *** ## What the MCP Server Cannot Do The following actions are not supported: * ❌ Create or modify a trade * ❌ Delete data * ❌ Change settings * ❌ Execute or confirm trades The MCP server is strictly read-only and follows the same data permissions as your Molecule login. *** ## Data Safety #### Can the AI modify my trades or positions? No, not currently. The Molecule MCP server is strictly read-only. It can retrieve and present your data, but it cannot create, edit, delete, or execute any trades, positions, allocations, or other records in Molecule. There is no mechanism for the AI to write back to Molecule through this integration. #### Who can see my Molecule data when I use this? Your Molecule data is only accessible to the AI assistant you are using (e.g., Claude, ChatGPT, etc.). The MCP server enforces the same data permissions as your Molecule login — you can only query data that your Molecule account already has access to. If you cannot see a book or position in Molecule, the AI will not be able to retrieve it either. Molecule does not grant the AI any elevated access. Your data is retrieved on-demand per query and is not stored in a separate database by the MCP server. #### Does Anthropic (Claude) or OpenAI (ChatGPT) store my Molecule data? Your Molecule data is passed to the AI model to formulate a response, and is subject to the data handling and retention policies of your AI provider (Anthropic or OpenAI). Before enabling the MCP integration, your organisation's admin should review those policies. Enterprise agreements with these providers typically include stricter data handling terms. #### Who at my organization can enable this feature? An Org Admin must first enable the Molecule MCP integration in the admin settings panel in Molecule (Settings → Access Control → MCP Server). Individual users can then connect their AI client using the settings screen. Org Admins can also disable MCP access for the entire organisation at any time, or for any individual user or group. #### Can Molecule support staff see my data through the MCP server? Molecule support staff have the same data access as your existing support agreement. The MCP server does not create any new access paths for Molecule employees. *** ## Data Accuracy Important disclaimer: Molecule surfaces your data exactly as it appears in the platform. The AI assistant may summarise, round, or interpret that data differently from how it is stored. The AI may also make errors in aggregation, date filtering, or unit conversions. Always verify critical figures against the Molecule UI before making trading decisions, reporting to counterparties, or submitting to regulators. #### Why does the AI's P\&L number not match what I see in Molecule? It should. Does it not? Contact support. This can happen for a few reasons: 1. Rounding — The AI may round figures when presenting them. 2. Summarisation — The AI may aggregate across books or dates differently than the view you're looking at in Molecule. 3. Timing — The AI fetches a snapshot at query time. Molecule may have updated since. 4. Interpretation — The AI may interpret "MTD P\&L" differently depending on how you phrase the question. If a number looks wrong, ask the AI to show more detail, or go directly to the Molecule UI to verify. #### Is market data real-time? The MCP server returns data as it exists in Molecule at the time of your query. Whether that data is real-time, delayed, or end-of-day depends on your Molecule configuration and data feeds, not the MCP integration.