{"name":"sellio","title":"Sellio","version":"1.0.0","description":"Read-only access to a Sellio workspace: conversations, messages, contacts, tickets and support performance.","instructions":"Sellio is a shared inbox and live chat platform for customer support teams. Conversations reach it from a website chat widget, WhatsApp, Instagram, Telegram, email, Slack, Discord and Microsoft Teams, and an AI agent trained on the workspace's own content answers first.\n\nReach for these tools when the user asks about their own customer support: what is in the inbox, what a particular customer said, who has been in touch, what tickets are outstanding, or how support performed over a period. They read one Sellio workspace, the one the API key belongs to.\n\nDo not use them for general questions about Sellio the product, its pricing or its documentation. Those are on the website, and https://sellio.chat/llms.txt indexes it.\n\nEverything here is read-only. No tool can send a message, close a conversation, change a ticket or alter a contact, so nothing you call can be seen by a customer.\n\nTools other than get_api_status need a workspace API key sent as `Authorization: Bearer sk_live_...`. Keys are created in the Sellio dashboard under Settings, Install, API keys, and carry scopes; a key missing a scope gets a clear refusal rather than an empty result.","endpoint":"https://sellio.chat/mcp","transport":"streamable-http","protocolVersion":"2025-06-18","protocolVersions":["2025-06-18","2025-03-26","2024-11-05"],"capabilities":{"tools":{"listChanged":false}},"authentication":{"type":"http","scheme":"bearer","description":"A Sellio workspace API key, sent as `Authorization: Bearer sk_live_...`. Create one in the dashboard under Settings, Install, API keys. `initialize`, `tools/list` and the get_api_status tool work without one.","tokenSource":"https://sellio.chat/docs/api#authentication"},"documentation":"https://sellio.chat/docs/api","openapi":"https://sellio.chat/openapi.json","tools":[{"name":"list_conversations","title":"List support conversations","description":"List the support conversations in the connected Sellio workspace, most recent activity first. Each row carries the visitor, the status, how many messages it holds and when it last moved. Use it to answer questions about what is in the inbox right now, to find a conversation before fetching its messages, or to count open work. Filter by status to look at only open, pending, resolved or closed conversations.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["open","closed","resolved","pending"],"description":"Return only conversations in this state. Omit for all of them."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"How many rows to return, 1 to 100. Defaults to 50."},"offset":{"type":"integer","minimum":0,"default":0,"description":"How many rows to skip. Use with limit to page through results."}},"required":[],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":["string","null"]},"status":{"type":"string","enum":["open","closed","resolved","pending"]},"priority":{"type":["string","null"]},"visitorName":{"type":["string","null"]},"visitorNameUnverified":{"type":"boolean","description":"True when identity verification is on and the visitor typed this name or sent it without a valid signature. Do not treat it as the customer's identity."},"visitorEmail":{"type":["string","null"],"description":"With identity verification on, only an address a signature covered."},"messageCount":{"type":"integer"},"lastMessageAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","status","messageCount","createdAt"],"additionalProperties":false}}},"required":["conversations"],"additionalProperties":false},"annotations":{"title":"List support conversations","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_conversation_messages","title":"Read a conversation","description":"Read the messages in one Sellio conversation, oldest first, up to 200 of them. Deleted messages are excluded. Use it after list_conversations to see what was actually said, who said it, and whether the AI agent or a person answered. A conversation id from another workspace returns an error rather than a transcript.","inputSchema":{"type":"object","properties":{"conversationId":{"type":"string","description":"The conversation id, as returned by list_conversations."}},"required":["conversationId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"senderType":{"type":"string","description":"Who sent it: the visitor, an agent, the AI agent, or the system."},"content":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","senderType","createdAt"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false},"annotations":{"title":"Read a conversation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_contacts","title":"List contacts","description":"List the people who have contacted the connected Sellio workspace, most recently created first, with their name, email, phone and tags. Use it to look up who a customer is, to check whether somebody has been in touch before, or to export an audience. It does not search: page through with limit and offset.","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"How many rows to return, 1 to 100. Defaults to 50."},"offset":{"type":"integer","minimum":0,"default":0,"description":"How many rows to skip. Use with limit to page through results."}},"required":[],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"}},"required":["id","createdAt"],"additionalProperties":false}}},"required":["contacts"],"additionalProperties":false},"annotations":{"title":"List contacts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_tickets","title":"List tickets","description":"List the tickets in the connected Sellio workspace, most recently created first. A ticket is work raised out of a conversation that continues after the conversation ends: a refund, a bug, a callback. Each row carries its number, status, priority and the conversation it came from. Use it to answer what is outstanding rather than what is being talked about.","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"How many rows to return, 1 to 100. Defaults to 50."},"offset":{"type":"integer","minimum":0,"default":0,"description":"How many rows to skip. Use with limit to page through results."}},"required":[],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"tickets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"integer"},"subject":{"type":["string","null"]},"status":{"type":"string"},"priority":{"type":["string","null"]},"conversationId":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","number","status","createdAt"],"additionalProperties":false}}},"required":["tickets"],"additionalProperties":false},"annotations":{"title":"List tickets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_support_performance","title":"Get support performance","description":"Get the support performance totals for a date range in the connected Sellio workspace: conversation volume, how many a human joined, how many the AI agent resolved alone, and the CSAT score. It returns the range you asked for alongside the equally long range immediately before it, so a change can be reported rather than just a number. Defaults to the last seven days; the range cannot exceed 366 days.","inputSchema":{"type":"object","properties":{"from":{"type":"string","format":"date-time","description":"Start of the range as an ISO 8601 date or date-time. Defaults to seven days before `to`."},"to":{"type":"string","format":"date-time","description":"End of the range as an ISO 8601 date or date-time. Defaults to now."}},"required":[],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"period":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false},"totals":{"type":"object","properties":{"volume":{"type":"integer","description":"Conversations in the range."},"involved":{"type":"integer","description":"Conversations a human joined."},"aiResolved":{"type":"integer","description":"Conversations the AI agent closed alone."},"automationRate":{"type":"number","description":"aiResolved as a percentage of volume."},"involvementRate":{"type":"number","description":"involved as a percentage of volume."},"resolutionRate":{"type":"number","description":"aiResolved as a percentage of involved."},"cxScore":{"type":"number","description":"Positive ratings as a percentage of rated."},"rated":{"type":"integer"},"positive":{"type":"integer"}},"required":["volume","involved","aiResolved"],"additionalProperties":false},"previous":{"type":"object","properties":{"volume":{"type":"integer","description":"Conversations in the range."},"involved":{"type":"integer","description":"Conversations a human joined."},"aiResolved":{"type":"integer","description":"Conversations the AI agent closed alone."},"automationRate":{"type":"number","description":"aiResolved as a percentage of volume."},"involvementRate":{"type":"number","description":"involved as a percentage of volume."},"resolutionRate":{"type":"number","description":"aiResolved as a percentage of involved."},"cxScore":{"type":"number","description":"Positive ratings as a percentage of rated."},"rated":{"type":"integer"},"positive":{"type":"integer"}},"required":["volume","involved","aiResolved"],"additionalProperties":false}},"required":["period","totals","previous"],"additionalProperties":false},"annotations":{"title":"Get support performance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_api_status","title":"Check the Sellio API","description":"Check that the Sellio API is reachable and its database is answering. Needs no API key, so it is the one tool worth calling to confirm a connection before asking the user for a credential.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean"},"ts":{"type":"string","format":"date-time"}},"required":["ok","ts"],"additionalProperties":false},"annotations":{"title":"Check the Sellio API","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}]}