--- title: Historian MCP Server description: The Timebase Historian has a built-in HTTP MCP Server for use with AI Agents and Assistants --- [Skip to content](https://docs.timebase.flow-software.com/en/knowledge-base/historian-mcp-server#main-content) English Show submenu for translations [More support](http://docs.timebase.flow-software.com/en/knowledge-base/kb-tickets/new?hsLang=en) ![Flow Software 300px-1](http://docs.timebase.flow-software.com/hs-fs/hubfs/Flow%20Software%20300px-1.png?width=120&height=43&name=Flow%20Software%20300px-1.png) Open main navigation Close main navigation - English Show submenu for translations - [More support](http://docs.timebase.flow-software.com/en/knowledge-base/kb-tickets/new) - [Ask Flow Support](http://timebase.flow-software.com/en/knowledge-base/kb-tickets/new) [Ask Flow Support](http://timebase.flow-software.com/en/knowledge-base/kb-tickets/new) Stay Curious & Keep Growing! - There are no suggestions because the search field is empty. 1. [Timebase Knowledge Base](http://docs.timebase.flow-software.com/en/knowledge-base?hsLang=en) 2. [Timebase Historian](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-historian?hsLang=en) - [Software Releases](http://docs.timebase.flow-software.com/en/knowledge-base/software-releases?hsLang=en#main-content) - [Timebase](http://docs.timebase.flow-software.com/en/knowledge-base/software-releases?hsLang=en#timebase) - [Timebase Quick Start](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#main-content) - [Start Here](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#start-here) - [System Requirements](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#system-requirements) - [Advanced Topics](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-quick-start?hsLang=en#advanced-topics) - [Timebase Historian](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-historian?hsLang=en) - [Timebase Data Collectors](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-data-collectors?hsLang=en) - [Timebase Explorer](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-explorer?hsLang=en) - [Timebase Pulse](http://docs.timebase.flow-software.com/en/knowledge-base/timebase-pulse?hsLang=en) - [Windows Services Starter](http://docs.timebase.flow-software.com/en/knowledge-base/windows-services-starter?hsLang=en) # Historian MCP Server ## The Timebase Historian has a built-in HTTP MCP Server for use with AI Agents and Assistants   [**What is MCP?**](https://docs.timebase.flow-software.com/en/knowledge-base/historian-mcp-server#what-is-mcp) [**Where to find it?**](https://docs.timebase.flow-software.com/en/knowledge-base/historian-mcp-server#where-to-find-it) [**How to use it?**](https://docs.timebase.flow-software.com/en/knowledge-base/historian-mcp-server#how-to-use-it)   --- ### What is MCP? MCP, or **Model Context Protocol**, is an open standard developed by [Anthropic](https://modelcontextprotocol.io/introduction)that allows AI models, like Gemini or GPT4, to interact with external tools and data sources, like Timebase Historian. AI models work best when they have "context" - think of the tags, their metadata, and their data as being the "context", MCP as the connector or "protocol", and Gemini as the AI "model". The embedded MCP Server in Timebase Historian exposes "tools" to AI Agents and Assistants to access and analyze time-series data directly.   --- ### Where to find it? The MCP Server is built directly into the Timebase Historian and exposes a number of "tools" and "prompts" for compatible AI Agents and Assistants to make use of. Timebase Historian implements an **HTTP** MPC Server. The "entry point" to the MCP is the following address: **URL** `http://:4511/mcp`   Here is an example connection using Postman: - In Postman, click "**New**", then select "MCP" ![](http://docs.timebase.flow-software.com/hs-fs/hubfs/Screenshot%202025-07-07%20at%2010-20-21%E2%80%AFAM-png.png?width=688&height=438&name=Screenshot%202025-07-07%20at%2010-20-21%E2%80%AFAM-png.png) - Timebase supports Streamable **HTTP (SSE)** MCP - make sure to select "HTTP", not "STDIO" - Enter the **URL** as specified above - Click "**Connect**" - If your Historian is running and the connection is successful, Postman will access the MCP Server and request information about the "**tools**" and "**prompts**" that are exposed: ![](http://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-22-2025-12-55-47-1019-PM.png?width=688&height=694&name=image-png-Jul-22-2025-12-55-47-1019-PM.png) **NOTE:** The default **HTTP** port is **4511** and the default **HTTPS **port is **4512**. Your port and IP address may be different if you changed the port and IP. --- ### How to use it? More and more AI Agents and Assistants are adding support for MCP Clients every day. Please refer to the documentation for these MCP Clients to configure and troubleshoot where necessary. We expect a number of AI Chat applications like ChatGPT will add support very soon. Here are some examples: #### Agents - [Claude Desktop by Anthropic](https://claude.ai/login?returnTo=%2F%3F) - [VS Code by Microsoft](https://code.visualstudio.com/mcp) - [Cursor](https://docs.cursor.com/welcome) - [Windsurf](https://modelcontextprotocol.io/introduction) #### Assistants - [Copilot Studio by Microsoft](https://github.com/features/copilot) - [LibreChat](https://www.librechat.ai/) - [ChatGPT](https://chatgpt.com/) #### Frameworks - [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/) - [LangGraph](https://www.langchain.com/langgraph) Please see an example of Claude's configuration file settings below: ``` "Timebase_Historian_MCP": {            "command": "npx",            "args": [                "-y",                "mcp-remote",               "http://:4511/mcp/sse",                "--transport",                "sse-only",                "--allow-http"            ],            "timeout": 30000,            "initTimeout": 10000        } ``` Note: The MCP Server is a Historian feature add-on available to use for free while in BETA. See [Licensing](https://timebase.flow-software.com/en/knowledge-base/timebase-licensing).   [![Flow Software 300px](http://docs.timebase.flow-software.com/hs-fs/hubfs/Flow%20Software%20300px.png?width=100&height=36&name=Flow%20Software%20300px.png "Flow Software 300px")](https://flow-software.com) Copyright © 2025, Flow Software