Session Tools
Sessions are the fundamental unit of work in the OpenBI MCP Server. Each session has its own isolated working store and is bound to one BI site.
create_session
Creates a new OpenBI session and binds it to id_site. Does not create assets — use create_asset for empty assets or load_openbi_asset to import JSON from disk.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id_site |
string |
✅ | Site id from list_sites (must match idSite in sites/*.json) |
Response
{
"status": "Success",
"sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"idSite": "my-bi-site"
}
| Field | Description |
|---|---|
status |
"Success" or "Error" |
sessionId |
GUID to pass as session_id to all subsequent tools |
idSite |
The site this session is bound to |
Notes
- Sessions persist for the lifetime of the server process. They are not shared between requests.
- A session can hold multiple assets. Each asset is created separately with
create_asset. - There is no explicit
close_sessiontool — sessions are cleaned up when the server process ends.