MCP server
Octadesk MCP by usefulapi
Search tickets, read conversations and people; create and update tickets and people in…
- Runs
- Remotely
- Version
- 1.4.0
- Listing updated
- 4 days ago
About Octadesk MCP by usefulapi
Octadesk MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Search tickets, read conversations and people; create and update tickets and people in Octadesk.
Install
Run in a terminal
claude mcp add --transport http octadesk https://octadesk.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://octadesk.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"octadesk": {
"url": "https://octadesk.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"octadesk": {
"type": "http",
"url": "https://octadesk.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"octadesk": {
"serverUrl": "https://octadesk.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"octadesk": {
"type": "http",
"url": "https://octadesk.usefulapi.io/mcp"
}
}
}Tools this server provides (13)
Read directly from the server.
- octadesk_search_tickets
- Search tickets with optional filters. Returns the page of tickets plus paging fields (total_count, search_id, next_page_url). For the next page, pass the same filters with the returned search_id and page + 1. GET /tickets/search.
- octadesk_get_ticket
- Get one ticket by its number, with its fields and status. GET /tickets/{number}.
- octadesk_get_ticket_interactions
- List the interactions of one ticket: replies, internal notes and property changes, in order. GET /tickets/{number}/interactions.
- octadesk_list_requester_tickets
- List the tickets of one requester. Pass last_number to read past the last ticket of the previous page. GET /tickets.
- octadesk_list_custom_ticket_lists
- List the saved custom ticket lists (views) of the account. GET /tickets/custom-lists.
- octadesk_find_person_by_email
- Find one person (requester or agent) by exact e-mail address. GET /persons?email=.
- octadesk_get_person
- Get one person by id. GET /persons/{id}.
- octadesk_search_requesters
- Search requesters (customers who open tickets) by e-mail or name. GET /persons/requesters.
- octadesk_search_agents
- Search agents (staff who work tickets) by e-mail or name. GET /persons/agents.
- octadesk_create_ticket
- Create a ticket. Common keys of `ticket`: summary, requester ({ email, name } or { id }), idGroupAssigned, idAssigned, idPriority, idCurrentStatus, idSubject, tags (string array), comments ({ internal: { content } } for an agent-only note, { public: { content } } for a reply the requester can read). POST /tickets.
- octadesk_update_ticket
- Change fields of one ticket, for example status, priority, assignee or group. Send only the fields to change. A `comments.public` entry is e-mailed to the requester. PUT /tickets/{number}.
- octadesk_create_person
- Create a person (requester or agent). Send the person fields, for example email and name. POST /persons.
- octadesk_update_person
- Change fields of one person. Send only the fields to change. PATCH /persons/{id}.
Octadesk MCP by usefulapi FAQ
How do I add Octadesk MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http octadesk https://octadesk.usefulapi.io/mcp