MCP

Siit's MCP Server exposes your workspace to AI tools that support the Model Context Protocol: Claude, Codex, Mistral, Cursor and more.

The Siit Model Context Protocol (MCP) app allows your third-party AI assistant to access your Siit data and account, so they can read and analyze your requests, and audit and update your service desk.

Setup Instructions

Tools authenticate with your Siit account via OAuth and can read and act on requests, people, and catalog resources within the data you can access in the Siit admin dashboard.

Server URL: https://mcp.siit.io/mcp Auth: OAuth 2.1 with dynamic client registration. Actions are performed on behalf of the authenticated user; access is scoped to the same data as in the Siit admin dashboard. Transport: Streamable HTTP.

For step-by-step connection instructions for each client, see the Help Center setup guide.

---

What you can do with MCP today

Access follows the same scoping as the Siit admin dashboard, the MCP cannot return data that the authenticated user cannot already see, or perform writes that the authenticated user cannot already perform in the UI.

Requests

Tool	Read / Write	Description
list_requests	Read	List open requests with full context: requester, status, linked apps, equipment, SLA
get_request	Read	Fetch a single request by ID with all nested details
get_request_events	Read	List the full timeline of events on a request
get_request_agent_logs	Read	Retrieve the AI agent's execution timeline: messages, tool calls, decisions
update_request	Write	Update any field on a request: status, assignee, priority, tags, linked apps, linked equipment
send_request_message	Write	Send a message in a request thread
add_request_note	Write	Add an internal note on a request
list_request_tags	Read	List all request tags
get_request_tag	Read	Fetch a single request tag

People

Tool	Read / Write	Description
list_people	Read	List users in your workspace
get_person	Read	Fetch a user with full profile: department, office location, Okta groups, and more
create_person	Write	Create a new user
update_person	Write	Update a user's profile
archive_person	Write	Archive a user
unarchive_person	Write	Restore an archived user
merge_person	Write	Merge two users into one
whoami	Read	Return the currently authenticated user

CMDB (Apps & Equipments)

Tool	Read / Write	Description
list_applications	Read	List all apps in your catalog
get_application	Read	Fetch a single app with full details
create_application	Write	Add an app to your catalog
update_application	Write	Update an app
list_equipments	Read	List all equipment in your inventory
get_equipment	Read	Fetch a single equipment with full details
create_equipment	Write	Add equipment to your inventory
update_equipment	Write	Update an equipment
list_equipment_categories	Read	List all equipment categories

Services

Tool	Read / Write	Description
list_services	Read	List all services available in your catalog
get_services	Read	Fetch a single service with its configuration
create_service	Write	Create a new service
update_service	Write	Update a service
create_service_custom_form_input	Write	Add a custom form field to a service
get_service_custom_form_input	Read	Fetch a single custom form field
update_service_custom_form_input	Write	Update a custom form field
delete_service_custom_form_input	Write	Permanently delete a custom form field

Knowledge base

Tool	Read / Write	Description
list_articles	Read	List knowledge base articles
get_article	Read	Fetch a single article
create_article	Write	Create a new article
update_article	Write	Update an article
publish_article	Write	Publish an article to the knowledge base
unpublish_article	Write	Revert an article to draft
archive_article	Write	Archive an article
unarchive_article	Write	Restore an archived article
list_article_categories	Read	List knowledge base categories

Organization

Tool	Read / Write	Description
list_teams	Read	List all teams
get_team	Read	Fetch a single team
list_team_inboxes	Read	List all inboxes
get_team_inbox	Read	Fetch a single inbox
list_departments	Read	List all departments
get_department	Read	Fetch a single department
list_office_locations	Read	List all office locations
get_office_location	Read	Fetch a single office location
list_legal_entities	Read	List all legal entities
get_legal_entity	Read	Fetch a single legal entity

---

Use case examples

• Triage your inbox without opening Siit : Ask Claude "What are the open P1 requests assigned to no one?" and get a prioritized list with full context — requester department, linked apps, SLA status — then instruct it to assign and update them directly.

• Investigate a request end to end : Paste a Siit request link into Claude Code and ask it to investigate: who raised it, what app or equipment is involved, what their Okta group is, and whether there are similar open requests. Get a full diagnosis in seconds.

• Run ad hoc analysis across your IT data : Ask questions like "How many open requests are linked to Slack?" or "Show me all requests from the Engineering team this week" — combining Siit data with other connected tools like Notion or Linear for richer context.

• Draft and send a reply from your AI client : Ask Claude to draft a response to a specific request based on its context, then send it as a message in the thread — without ever switching tabs.

• Bulk triage after a tool outage : Ask "List all requests created in the last 2 hours linked to Okta, assign them to the IT team inbox, and tag them as incident." Done in one prompt.

---

Coming soon

• Take actions on other Siit's objects : people, Apps, Equipments

• Manage services, workflows

• Create & Update knowledge base articles