Skip to content
English
More support Ticket overview Sign in
  • There are no suggestions because the search field is empty.

Shoreline MCP server

The Shoreline MCP server connects Shoreline data to supported AI assistants. It lets approved users ask questions about operational data in natural language instead of manually searching across multiple Shoreline areas.

Use the Shoreline MCP server to find, summarize, and compare information such as work orders, personnel, work packages, activities, teams, timesheets, defects, inventories, rotations, and checklists.

The Shoreline MCP server is read-only for the workflows described in this article. It retrieves Shoreline information; it does not create, edit, approve, reject, or delete Shoreline records.

In this article

  • Where to find the Shoreline MCP server

  • Prerequisites

  • Connect an AI assistant to Shoreline MCP

  • Ask questions about Shoreline data

  • Available data

  • Filters and time ranges

  • Data that requires a specific ID

  • Permissions and access

  • Limitations

  • Troubleshooting

Where to find the Shoreline MCP server

The Shoreline MCP server is not shown as a standard page inside Shoreline.

You access it through an AI assistant or MCP-compatible client that your organization has connected to Shoreline. Your Shoreline administrator or IT team should provide:

  • The AI assistant or MCP client to use

  • The Shoreline MCP server connection details

  • Any required access token

  • The Shoreline project or environment connected to the server

If your organization uses Claude Desktop, the Shoreline MCP server may be available after your administrator has configured it in Claude Desktop.

Prerequisites

Before you use the Shoreline MCP server, make sure the following are in place:

  • Your organization has configured the Shoreline MCP server.

  • You are using an AI assistant or client that supports MCP connections.

  • You have access to the Shoreline MCP connection.

  • If your organization requires an access token, you have a valid token.

  • The connection points to the correct Shoreline project or environment.

  • The data you are asking about exists in the connected Shoreline project.

Connect an AI assistant to Shoreline MCP

The exact setup steps depend on the AI assistant or MCP client your organization uses.

  1. Open your AI assistant or MCP-compatible client.

  2. Go to the area where MCP servers, tools, or external connections are managed.

  3. Add the Shoreline MCP server using the connection details provided by your administrator.

  4. If prompted, enter the required access token.

  5. Save the connection.

  6. Start a new conversation in the AI assistant.

  7. Ask a Shoreline-related question.

Example questions:

  • “Show urgent work orders changed in the last 30 days.”

  • “Which teams are connected to this work package?”

  • “Summarize defects for this project.”

  • “Find timesheets pending approval this month.”

If you cannot see the Shoreline MCP server in your AI assistant, contact your Shoreline administrator or IT team.

Ask questions about Shoreline data

Use natural language. Include the record type, filters, and time range when possible.

  1. Open your AI assistant.

  2. Ask a question about Shoreline data.

  3. Include any known names, IDs, statuses, priorities, or dates.

  4. Review the answer.

  5. Ask a follow-up question if you need a narrower result.

Examples:

  • “Show work orders with priority URGENT changed in the last 3 months.”

  • “Find personnel named Anna in the Service department.”

  • “List planned work packages in Denmark for next month.”

  • “Show completed activities for this work package.”

  • “Find timesheets with status PENDING from April.”

  • “Show inventory reservations for this inventory.”

  • “Get approval statuses for this defect.”

For best results, be specific.

Instead of:

  • “Show open work.”

Ask:

  • “Show urgent work orders changed since 1 March 2026.”

  • “Show activities with status DISPATCHED for work package [name or ID].”

  • “Find timesheets with status PENDING between 1 April and 30 April 2026.”

Available data

The Shoreline MCP server can retrieve the following Shoreline data.

Data type What you can ask for
Work orders Work orders by ID, name, type, priority, work package, work order sequence, work order plan, or changed date
Personnel Personnel by ID, name, email, role, department, team, work package, or changed date
Work packages Work packages by ID, name, status, country, asset type, date range, timezone, or changed date
Work order plans Work order plans by ID, name, or changed date
Timesheets Timesheets by ID, name, status, date range, submitter, approver, time entry, activity, work package, personnel, or changed date
Teams Teams by ID, name, type, department, work package, or team composition
Team positions Team positions by team, composition, position, name, or status
Team compositions Team compositions by team, name, composition, work package, date range, or position
Personnel rotations Rotations, travel, and unavailability for a specific person
Inventories Inventory records, inventory names, and inventory groups
Inventory transactions Inventory restocks, reservations, pickups, and consumptions for a specific inventory
Defects Defects, defect types, priorities, error codes, categories, and approval statuses
Checklists Checklists, including checklists linked to work orders
Activities Activities by ID, name, work package, work order, site, asset, status, date range, or changed date
Activity categories Activity categories by ID, name, work package, or changed date

Filters and time ranges

Many Shoreline MCP questions can include filters. You can combine filters in one question.

Common filters include:

  • Names

  • IDs

  • Statuses

  • Types

  • Priorities

  • Departments

  • Teams

  • Work packages

  • Work orders

  • Personnel

  • Countries

  • Asset types

  • Sites

  • Assets

  • Date ranges

  • Changed date

For most time-based questions, the AI assistant uses the last 3 months of data by default unless you ask for a different period.

You can ask for a different time range, for example:

  • “Show work orders changed since 1 January 2026.”

  • “Find activities between 1 April and 30 April 2026.”

  • “Show timesheets from the last 14 days.”

  • “Search all available data for this work package.”

Some reference data does not use date filters. This includes:

  • Teams

  • Team positions

  • Defect types

  • Defect priorities

  • Defect error codes

  • Defect categories

  • Inventory names

  • Inventory groups

  • Inventories

  • Checklists

Data that requires a specific ID

Some requests require a specific Shoreline record ID.

Request Required information
Personnel rotations Personnel ID
Inventory restocks Inventory ID
Inventory reservations Inventory ID
Inventory pickups Inventory ID
Inventory consumptions Inventory ID
Defect approval statuses Defect ID

If you do not know the ID, first ask the AI assistant to find the relevant record by name or other filters. Then use the ID from that result in your follow-up question.

Example:

  1. Ask: “Find personnel named Maria Hansen.”

  2. Review the results and identify the correct person.

  3. Ask: “Show rotations for this personnel ID for the next 3 months.”

Another example:

  1. Ask: “Find the inventory for hydraulic oil.”

  2. Review the inventory results.

  3. Ask: “Show reservations for this inventory ID.”

Available settings, filters, actions, and views

The Shoreline MCP server does not have a separate settings page or visual dashboard in Shoreline.

The available options depend on what you ask the AI assistant to retrieve.

Common actions

You can ask the assistant to:

  • Find matching records

  • Summarize records

  • Compare records

  • Filter records by status, date, team, work package, or other supported fields

  • Retrieve related information, such as checklists for work orders or rotations for personnel

Common filters

You can filter many requests by:

  • ID

  • Name

  • Status

  • Date range

  • Changed date

  • Work package

  • Work order

  • Personnel

  • Team

  • Department

  • Priority

  • Type

Common views

The Shoreline MCP server returns information in the AI assistant conversation. It does not open a Shoreline screen or change your Shoreline view.

You can ask the assistant to format the answer as:

  • A short summary

  • A table

  • A list

  • A grouped overview

  • A comparison

  • A follow-up question list

Example:

“Show urgent work orders changed in the last 30 days. Format the result as a table with work order, priority, work package, and changed date.”

Permissions and access

Access to the Shoreline MCP server is controlled by your organization’s setup.

You may need:

  • Access to the AI assistant or MCP client

  • Access to the Shoreline MCP server connection

  • A valid access token, if your organization requires one

  • Approval from your Shoreline administrator to use the connected Shoreline project or environment

The data available through the Shoreline MCP server depends on the Shoreline project or environment configured for the connection. If the server is connected to one project, it will not return data from another project unless that connection has also been configured.

It is not clear whether the Shoreline MCP server applies each individual user’s Shoreline role permissions after the connection is configured. Treat the connection as organization-controlled and only share it with users who are approved to view the connected Shoreline data.

Limitations

  • The Shoreline MCP server is read-only for the supported workflows.

  • It does not create, edit, approve, reject, or delete Shoreline records.

  • It is not a standard page inside Shoreline.

  • It must be connected through a supported AI assistant or MCP-compatible client.

  • Results are limited to the Shoreline project or environment configured for the connection.

  • For most operational data, the AI assistant uses the last 3 months by default unless you ask for a different time range.

  • Some reference data does not support date filters.

  • Some requests require exact Shoreline record IDs.

  • Broad questions or large date ranges may take longer to complete.

  • Very broad requests may time out.

  • If the connected Shoreline project does not match an existing project, the assistant cannot return data.

  • If no matching data exists for the connected project and filters, the assistant may return a “no data found” response.

  • If an access token is required and it is missing, incorrect, or expired, the connection will fail.

  • The exact setup steps vary by AI assistant or MCP client.

Troubleshooting

I cannot see the Shoreline MCP server in my AI assistant

Ask your Shoreline administrator or IT team to confirm that:

  • The Shoreline MCP server has been configured for your AI assistant.

  • You are using the correct AI assistant or MCP client.

  • You have access to the connection.

  • The server connection details are correct.

  • The correct Shoreline project or environment is connected.

The AI assistant says it is not authorized

This usually means the required access token is missing, incorrect, or no longer valid.

  1. Check that you entered the access token exactly as provided.

  2. Confirm that there are no extra spaces before or after the token.

  3. Ask your administrator whether the token has changed.

  4. Reconnect the Shoreline MCP server in your AI assistant.

The assistant says no data was found

This can happen when there are no matching records for the connected project, date range, or filters.

Try the following:

  1. Confirm that the Shoreline MCP server is connected to the correct Shoreline project.

  2. Ask again with a broader date range.

  3. Remove one or more filters.

  4. Search for the record by name first.

  5. Use the returned ID in a follow-up question.

Example:

Instead of:

  • “Show reservations for this inventory.”

Ask:

  1. “Find inventories related to hydraulic oil.”

  2. “Show reservations for inventory ID [ID].”

The AI assistant cannot find the data I expected

Try narrowing or clarifying the question.

Instead of:

  • “Show the work orders.”

Ask:

  • “Show work orders changed in the last 30 days with priority URGENT.”

  • “Find work orders for work package [name or ID].”

  • “Show work orders with type Commissioning changed since 1 March 2026.”

Also confirm that the Shoreline MCP server is connected to the correct Shoreline project or environment.

The answer only includes recent data

For most operational data, the AI assistant uses the last 3 months by default. Ask for a specific date range if you need older data.

Example:

“Show work orders changed since 1 January 2025.”

You can also ask for all available data, but large requests may take longer and may time out.

The assistant asks for an ID

Some data requires a specific record ID, such as personnel rotations, inventory transactions, or defect approval statuses.

First ask the assistant to find the record by name or another filter. Then ask the follow-up question using the ID from the result.

Example:

  1. Ask: “Find defects related to blade damage.”

  2. Review the results and choose the correct defect.

  3. Ask: “Show approval statuses for defect ID [ID].”

The response takes a long time

Some requests take longer because Shoreline prepares the data before returning it to the AI assistant. This is expected for larger searches, broad date ranges, or questions that require a lot of operational data.

Try:

  • Asking for a shorter time range

  • Filtering by status, type, priority, team, project, or work package

  • Asking for one data type at a time

  • Using a known ID when available

  • Asking for a summary instead of all matching records

The request times out

A timeout can happen when the request is too broad or the data takes too long to prepare.

Try again with a narrower question.

Instead of:

  • “Show all work orders.”

Ask:

  • “Show urgent work orders changed in the last 30 days.”

  • “Show work orders for work package [ID] changed since 1 April 2026.”

  • “Show completed activities for work package [ID] last week.”

The results look incomplete

Check whether your question included enough detail. Also confirm:

  • You are connected to the correct Shoreline project.

  • The data exists in Shoreline.

  • The date range includes the records you expect.

  • The record type supports the filter you are using.

  • You have access to the Shoreline MCP connection.

The assistant returns too much information

Ask a more specific follow-up question.

Examples:

  • “Only show records with priority URGENT.”

  • “Group the results by work package.”

  • “Show only records changed in the last 7 days.”

  • “Summarize the top 10 most important items.”

  • “Format the result as a table with the most important fields only.”