# Stimulsoft Reports MCP Server: full documentation > Build and edit Stimulsoft report templates from your AI client. Your agent is the interface. Stimulsoft is the engine. This file holds the whole stimulsoft.io documentation in one place, for AI agents and LLM tools. The short index is at https://stimulsoft.io/llms.txt. Server address: `https://mcp.stimulsoft.io/mcp` Works with Claude, ChatGPT, Cursor, VS Code, Claude Code, and any other MCP client. ## Quickstart ### 1. Add the server to your AI client #### Claude Code ```bash claude mcp add --transport http stimulsoft https://mcp.stimulsoft.io/mcp ``` #### Cursor File `.cursor/mcp.json`: ```json { "mcpServers": { "stimulsoft": { "url": "https://mcp.stimulsoft.io/mcp" } } } ``` #### VS Code File `.vscode/mcp.json`: ```json { "servers": { "stimulsoft": { "type": "http", "url": "https://mcp.stimulsoft.io/mcp" } } } ``` #### Claude and ChatGPT Open Settings, then Connectors, add a custom connector, and paste the address: `https://mcp.stimulsoft.io/mcp`. #### JetBrains Open Settings, then Tools, AI Assistant, Model Context Protocol (MCP). Add a server and paste the address: `https://mcp.stimulsoft.io/mcp`. #### Windsurf File `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "stimulsoft": { "serverUrl": "https://mcp.stimulsoft.io/mcp" } } } ``` #### Codex CLI File `~/.codex/config.toml`: ```toml [mcp_servers.stimulsoft] url = "https://mcp.stimulsoft.io/mcp" ``` #### Zed File `~/.config/zed/settings.json`: ```json { "context_servers": { "stimulsoft": { "url": "https://mcp.stimulsoft.io/mcp" } } } ``` #### Cline File `cline_mcp_settings.json`: ```json { "mcpServers": { "stimulsoft": { "type": "streamableHttp", "url": "https://mcp.stimulsoft.io/mcp" } } } ``` ### 2. Log in The first time, your AI client opens the Stimulsoft login page. Log in with your Stimulsoft account and approve access. ### 3. Make your first report Ask your agent: > Create a sales report by region from this JSON and show me the PDF. ### 4. Change an existing report Give the agent your .mrt file and say what to change: > Add a total per region and make the header blue. The agent opens the template, applies the changes, and returns the updated .mrt file. ### 5. Use it in your app Save the .mrt file to your project and render it with Reports.NET, Reports.JS, or any other Stimulsoft engine. **Good to know.** A report stays open on the server for 4 hours after the last change. After that, the agent uploads it again. Download links work for 2 hours. ## Tools | Tool | What it does | Example request | Changes the report | |---|---|---|---| | `sti_open_report` | Loads an .mrt or .mrz template and returns a ReportId with an overview. | “Open Invoice.mrt and tell me what is in it.” | No | | `sti_get_report_overview` | Report properties and the list of pages. | “How many pages does this report have?” | No | | `sti_get_page` | One page with all its components. | “Show me everything on page 2.” | No | | `sti_get_dictionary` | Data sources, relations, variables, functions, resources. | “Which data sources does this report use?” | No | | `sti_get_styles` | Styles defined in the report. | “List the styles in this report.” | No | | `sti_apply_commands` | Applies a batch of editing commands. | “Make the header blue and add a Discount column.” | Yes | | `sti_screenshot_page` | A picture of a page as it looks in the designer. | “Show me how page 1 looks.” | No | | `sti_export` | Renders the report, exports it, and returns a download link that works for 2 hours. | “Export the report to PDF.” | No | | `sti_save_report` | Returns a download link to the .mrt template. The link works for 2 hours. | “Give me the finished .mrt file.” | No | | `sti_create_empty_report` | Creates an empty report or dashboard for your data. | “Start a new report for my sales file.” | Yes | | `sti_add_file_data_source` | Connects a data file: JSON, XML, CSV, Excel, DBF, or WKT, up to 5 MB. | “Use this Excel file as the data.” | Yes | | `sti_add_sql_data_source` | Connects an MS SQL database with a public address. | “Connect to my SQL Server database.” | Yes | | `sti_get_data_preview` | Shows the first rows of a data source. | “Show me the first rows of Orders.” | No | | `sti_generate_report_layout`, `sti_generate_dashboard_layout` | Builds a report or a dashboard on the data you connected. | “Build a sales report on this data.” | Yes | | `sti_check_report`, `sti_fix_report_check` | Finds errors and warnings and applies automatic fixes. | “Why doesn’t my report build?” | Yes | | `sti_get_globalization_strings` | Lists the texts to translate. The agent saves the translations with editing commands. | “Translate the report into German.” | No | | `sti_get_integration_code` | Code that loads the template in a .NET app: Console, WinForms, WPF, or ASP.NET Core. | “Write the code that loads Invoice.mrt.” | No | | `sti_get_my_account` | Shows which Stimulsoft account is connected. | “Which account am I using?” | No | | `sti_get_report_generation_instructions`, `sti_generate_report` | Create a new report from scratch. | “Create a sales report by region from this JSON.” | Yes | | `sti_get_dashboard_generation_instructions`, `sti_generate_dashboard` | Create a new dashboard from scratch. | “Build a KPI dashboard from this Excel file.” | Yes | | Reference tools, about 70 | Editing commands, functions, system variables, component schemas, barcodes, shapes, maps. | “Which function formats a date as a quarter?” | No | ## Export formats PDF, XPS, HTML5, Excel, Excel 97-2003 (XLS), Word, PowerPoint, RTF, CSV, Text, XML, JSON, ODS, ODT, DBF, PNG, JPEG, SVG, TIFF, BMP, GIF. ## Two servers, two jobs **Stimulsoft Reports MCP Server** works with your reports. **Stimulsoft Documentation MCP Server** searches the documentation and code examples, is free, and needs no login. Connect both for the best results. Documentation server address: `https://devs.stimulsoft.com/mcp-docs` ## Plans and limits Start free. Pay monthly or yearly. Cancel anytime. Already have a Stimulsoft subscription? The MCP Server is included. | | Trial | Single | Team | Enterprise | |---|---|---|---|---| | Price | Free for 30 days | $45 a month | $135 a month | $405 a month | | Paid yearly | | $480 a year (save $60) | $1,440 a year (save $180) | $4,320 a year (save $540) | | Developers | 1 | 1 | 4 | 15 | | Pages per report | 20 | 100 | 200 | 500 | | Data rows | 5,000 | 20,000 | 50,000 | 100,000 | | File size | 5 MB | 10 MB | 15 MB | 25 MB | | Saved reports | 20 | Unlimited | Unlimited | Unlimited | | Renders per month | 500 | 3,000 | 10,000 | 30,000 | | API tokens | 150,000 | 1,500,000 | 3,000,000 | 10,000,000 | | Database connections | No | Yes | Yes | Yes | | White label | No | No | Yes | Yes | Need more than 15 developers? Write to sales@stimulsoft.com. ### Every plan includes - All server tools: create, edit, check, and export reports from your AI client. - Online report designer, plus a desktop designer for Windows, macOS, and Linux. - Unlimited reports in your Stimulsoft account, with roles and access control for your team (Trial: up to 20). - Export to PDF, Excel, Word, and many other formats. - On paid plans, MS SQL databases, plus JSON, XML, CSV, Excel, and DBF files. - Technical support from the Stimulsoft team. **Running reports inside your own app?** You need a Stimulsoft Reports license. The runtime designer and viewer you embed are royalty-free for your end users. Licenses: https://www.stimulsoft.com/en/online-store/products ### Questions **How does the trial work?** You get 30 days with the Trial limits and no card. When the trial ends, choose a plan to keep working. **Can I cancel anytime?** Yes. Your plan stays active until the end of the period you paid for. There are no refunds for the unused part. **What if a payment fails?** Access stops when the paid period ends. We email you 3 days before each monthly payment and 30 days before a yearly one, so you have time to update your card. **Can I change my plan?** Upgrades start right away, and you pay only the difference for the days left. Downgrades start with your next payment, with no refund. **What if I downgrade and have more developers than the new plan allows?** The downgrade still goes through. Developers above the limit lose access, starting with the most recently added. The account owner always keeps access. **Can I switch from monthly to yearly?** Yes. The unused part of your month counts toward the year. **What happens to my reports if I stop paying?** They stay in your account. Renew and everything is where you left it. Trial accounts that nobody logs in to for 12 months are removed, and we email you 30 days before that. **How is this different from a Stimulsoft Reports license?** A plan here gives you the server: building, storing, and previewing reports through your AI client. A license gives you the engine to render reports inside your own app. Many teams use both. **How do I pay?** Payments are handled by PayPro Global: cards, PayPal, and bank transfer. VAT is added where it applies and removed with a valid tax ID. ## Security What the Stimulsoft Reports MCP Server can access, where your reports go, and how to take access back. ### Where your reports go Three places are involved: 1. **Your data.** The database or the data files you connect to a report. 2. **The MCP Server.** It runs the tools. The template you work on is stored encrypted and deleted 4 hours after your last change. 3. **The AI client you connected.** It receives what the tools return. When your agent reads a template or gets a PDF, that content goes to the AI client you connected, at your direction. From there, the terms of that client apply. Exported files and saved templates come as a download link that works for 2 hours. Anyone with the link can open the file. ### No AI providers on our side Your agent’s model does the thinking. The server only runs tools. It does not send your reports, data, or prompts to any AI provider. ### Login and access - You log in with your Stimulsoft account. The server never sees your password. - Your AI client gets access through OAuth 2.1 after you log in and approve it. - You approve access on a consent screen that names the client and lists what it can do. - You can revoke any connected client at any time on the Account page. Access ends when the client’s current access token expires. ### What a connected client can do - Open a template you give it (.mrt or .mrz). - Create and edit templates. - Connect data sources to a template and work with its data. - Export a report to PDF, Excel, Word, or any other available format. It cannot change your password or your plan, and it cannot add or remove developers. ### Storage and encryption - Data is encrypted in transit and, where appropriate, at rest. - Hosting runs on Microsoft Azure. ### Report templates and code Templates are never compiled on the server, only interpreted, so code inside a template does not run. ### Deletion - Delete your account at any time on the Account page. Access is disabled at once and your content is deleted without undue delay. - Backups are cleared within 30 days. - Trial accounts that nobody logs in to for 12 months are removed, with an email 30 days before. ### Payments Payments are processed by PayPro Global. Card details never reach our servers. ### Privacy and compliance - Stimulsoft is operated by CloudReports sp. z o.o., Warsaw, Poland, and processes personal data under the GDPR. - A Data Processing Addendum is available on request at sales@stimulsoft.com. - If a personal data breach affects your content, we notify you without undue delay and, where feasible, within 72 hours. - Terms of Use: https://www.stimulsoft.com/en/terms-of-use - Privacy Policy: https://www.stimulsoft.com/en/privacy-policy ### Report a vulnerability Found a security issue? Write to security@stimulsoft.com. We reply to every report. ## Cookie Policy stimulsoft.io keeps a few things in your browser so the site works. Google Analytics runs only if you choose "Accept all" in the cookie banner. "Necessary only" keeps just what the site needs to work. You can change the choice at any time with "Cookie settings" in the footer. The same window lists what is kept, who sets it, and for how long. | What | Set by | How long | |---|---|---| | Login, your name in the menu, and your choices on the site (sio_session, sio_user, sio_consent, sio_newsletters, sio_deviceId) | stimulsoft.io | Until you log out. Your cookie choice: 12 months | | Bot protection on sign up and password reset (_GRECAPTCHA, rc::*) | Google reCAPTCHA | Up to 6 months | | Analytics, only if you choose "Accept all" (_ga, _ga_56Z9RJS5EL) | Google Analytics | Up to 2 years | When you log in, the site also makes a device ID from your browser and graphics settings and sends it to Stimulsoft Server, so logging in here does not end your other sessions. It is not saved. stimulsoft.io is run by CloudReports sp. z o.o. (dba Stimulsoft), Warsaw, Poland. Questions about cookies or your data: info@stimulsoft.com. ## Contact - Support: support@stimulsoft.com - Sales: sales@stimulsoft.com - Information: info@stimulsoft.com - Phone: +1-209-734-0001, +48-690-104-472 (Monday to Friday, 08:00 to 17:00 Warsaw time) Copyright © 2003-2026 CloudReports sp. z o.o. (dba Stimulsoft). All rights reserved.