_ registry / mcp streamable-http · checked 1h ago

edesk-mcp

https://edesk.usefulapi.io

Registry code: 86cd9d3a346f7ca1

api record

Tools for eDesk, hosted by usefulapi.io. Read-only tools never change data; ask the user before a tool that creates, changes or deletes eDesk data. Free plan: 100 tool calls per month. Run edesk_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run edesk_request_feature to record the request. Pro (unlimited calls, $9/month or $90/year): when the user wants more calls or reaches the limit, run edesk_upgrade; it returns a Stripe Checkout link for the user to open. edesk_cancel_subscription cancels Pro at…

endpoint
https://edesk.usefulapi.io/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is edesk-mcp live?
Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
Is edesk-mcp free to use?
No — it asks for a key or a login before it will serve.
What tools does edesk-mcp have?
18 tools: edesk_whoami, edesk_list_tags, edesk_list_sales_orders, edesk_list_channels, edesk_list_contacts, edesk_list_tag_groups, edesk_list_users, edesk_list_templates, ….
Is edesk-mcp safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
559ms

last good check

priced tools
0

of 18 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 18 tools
18 auth-required 18 of 18 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • edesk_whoami auth-required never probed

    The eDesk user the API token belongs to: id, name, email, username, role and active flag. GET /whoami.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {}
    }
    arguments 5 lines
  • edesk_list_tags auth-required never probed

    List ticket tags with id, name, color, active flag and tag group id. Use the ids in edesk_update_ticket (tag_ids). GET /tags.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_list_sales_orders auth-required never probed

    List the marketplace/store orders that eDesk holds, with status, items, amounts, addresses, tracking codes and the linked ticket id. Filter by status, channel, contact, marketplace order id, id range and created/updated dates. GET /sales-orders.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "id_to": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only orders with an eDesk id less than or equal to this.",
          "exclusiveMinimum": 0
        },
        "status": {
          "enum": [
            "OrderReceived",
            "PaymentReceived",
            "PaymentRejected",
            "PaymentAccepted",
            "OrderShipped",
            "InTransit",
            "Delivered",
            "Canceled",
            "Returned",
            "Hold"
          ],
          "type": "string",
          "description": "Only orders with this status."
        },
        "id_from": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only orders with an eDesk id greater than or equal to this.",
          "exclusiveMinimum": 0
        },
        "order_by": {
          "enum": [
            "id",
            "created_at",
            "last_updated_at"
          ],
          "type": "string",
          "description": "Sort field."
        },
        "channel_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only orders from this channel.",
          "exclusiveMinimum": 0
        },
        "contact_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only orders of this contact.",
          "exclusiveMinimum": 0
        },
        "created_after": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only orders created on or after this date, yyyy-mm-dd."
        },
        "updated_after": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only orders last updated on or after this date, yyyy-mm-dd."
        },
        "created_before": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only orders created on or before this date, yyyy-mm-dd."
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        },
        "updated_before": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only orders last updated on or before this date, yyyy-mm-dd."
        },
        "order_direction": {
          "enum": [
            "asc",
            "desc"
          ],
          "type": "string",
          "description": "Sort direction."
        },
        "seller_order_id": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only the order with this marketplace order id."
        }
      }
    }
    arguments 101 lines
  • edesk_list_channels auth-required 1h ago

    List the sales channels connected to eDesk (Amazon, eBay, Shopify, email, ...) with id, type, name, country and currency. Use the ids to filter tickets and orders. GET /channels.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_list_contacts auth-required 1h ago

    Search the contacts (customers) of the helpdesk by free text, email, name, phone number or consumer id. Returns id, channel, full name, email and phone. GET /contacts.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Filter by full name."
        },
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "email": {
          "type": "string",
          "maxLength": 320,
          "minLength": 1,
          "description": "Filter by email."
        },
        "query": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Free-text search."
        },
        "consumer_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Filter by consumer id.",
          "exclusiveMinimum": 0
        },
        "phone_number": {
          "type": "string",
          "maxLength": 50,
          "minLength": 1,
          "description": "Filter by phone number."
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 48 lines
  • edesk_list_tag_groups auth-required 1h ago

    List the tag groups that organize ticket tags. GET /tag-groups.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_list_users auth-required never probed

    List the eDesk users (support agents) with id, name, email, username, role and active flag. Use the ids as ticket owners. GET /users.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_list_templates auth-required never probed

    List saved reply templates (id, name, subject, body text, channels, usage). GET /templates.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_get_template auth-required never probed

    One reply template by id. GET /templates/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "template_id"
      ],
      "properties": {
        "template_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk template id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 15 lines
  • edesk_list_tickets auth-required never probed

    List support tickets from all channels with subject, type, status, channel, owner, contact, linked sales order id, tag ids, message ids, reply count and AI classification. Filter by status, type, channel, contact, owner, sales order, seller (marketplace) order id and last-updated date. GET /tickets.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "type": {
          "enum": [
            "BuyerNotes",
            "Cancellation",
            "Chat",
            "Chatbot",
            "ContactBuyer",
            "ContactForm",
            "DefectiveItemReceived",
            "FeedbackReply",
            "Incident",
            "InvoiceRequest",
            "NegativeFeedback",
            "OfferQuery",
            "OrderAdjustment",
            "OrderClaim",
            "OrderQuery",
            "OrderShippingInquiry",
            "PaymentsQuery",
            "Presales",
            "ProductQuery",
            "PublicMessage",
            "Query",
            "Refund",
            "ResolutionCase",
            "ReturnRequest",
            "ReturnsQuery",
            "SampleQuery",
            "ShippingQuery",
            "SystemMessage",
            "WrongItemReceived"
          ],
          "type": "string",
          "description": "Only tickets of this type."
        },
        "status": {
          "enum": [
            "Scheduled",
            "Spam",
            "Unread",
            "Read",
            "Unpriority",
            "Priority",
            "Archived",
            "Open",
            "Pending",
            "Closed"
          ],
          "type": "string",
          "description": "Only tickets with this status."
        },
        "order_by": {
          "enum": [
            "id",
            "created_at",
            "last_updated_at"
          ],
          "type": "string",
          "description": "Sort field."
        },
        "channel_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only tickets on this channel (see edesk_list_channels).",
          "exclusiveMinimum": 0
        },
        "contact_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only tickets of this contact (customer).",
          "exclusiveMinimum": 0
        },
        "owner_user_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only tickets assigned to this user.",
          "exclusiveMinimum": 0
        },
        "updated_after": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only tickets last updated on or after this date, yyyy-mm-dd."
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        },
        "sales_order_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "Only tickets linked to this eDesk sales order id.",
          "exclusiveMinimum": 0
        },
        "updated_before": {
          "type": "string",
          "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
          "description": "Only tickets last updated on or before this date, yyyy-mm-dd."
        },
        "order_direction": {
          "enum": [
            "asc",
            "desc"
          ],
          "type": "string",
          "description": "Sort direction."
        },
        "seller_order_id": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only tickets for this marketplace order id (the id the marketplace shows)."
        }
      }
    }
    arguments 126 lines
  • edesk_get_ticket auth-required never probed

    One ticket by id with its status, owner, tags, custom fields, linked sales order and the ids of its messages (read each with edesk_get_message). GET /tickets/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "ticket_id"
      ],
      "properties": {
        "ticket_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk ticket id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 15 lines
  • edesk_get_message auth-required never probed

    One ticket message or internal note by id (from a ticket's message ids): body, direction, type (Message or Note), author and attachments. GET /messages/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "message_id"
      ],
      "properties": {
        "message_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk message id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 15 lines
  • edesk_get_sales_order auth-required never probed

    One sales order by id with items, amounts, ship-to and bill-to addresses, tracking codes, delivery dates, the linked ticket id and order note ids. GET /sales-orders/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "sales_order_id"
      ],
      "properties": {
        "sales_order_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk sales order id (the sales_order_id on a ticket).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 15 lines
  • edesk_list_order_notes auth-required never probed

    List the internal notes attached to sales orders (id, sales order id, author, text, attachments). GET /order-notes.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 100000,
          "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
          "exclusiveMinimum": 0
        },
        "items_per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Results per page, 1-100 (default 25).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 18 lines
  • edesk_update_ticket auth-required never probed

    WRITE: change a ticket's status, owner (assignee), tags or subject. Only the fields you pass are sent. tag_ids is sent as given: read the ticket first (tags_ids) and include the tags to keep. Nothing is sent to the customer. PUT /tickets/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "ticket_id"
      ],
      "properties": {
        "status": {
          "enum": [
            "Scheduled",
            "Spam",
            "Unread",
            "Read",
            "Unpriority",
            "Priority",
            "Archived",
            "Open",
            "Pending",
            "Closed"
          ],
          "type": "string",
          "description": "New status, e.g. Open, Pending or Closed."
        },
        "subject": {
          "type": "string",
          "maxLength": 500,
          "minLength": 1,
          "description": "New subject."
        },
        "tag_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          },
          "maxItems": 100,
          "description": "Tag ids for the ticket (see edesk_list_tags)."
        },
        "ticket_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk ticket id.",
          "exclusiveMinimum": 0
        },
        "owner_user_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "User id to assign the ticket to (see edesk_list_users).",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 53 lines
  • edesk_add_ticket_note auth-required never probed

    WRITE: add an internal note to a ticket. The note is for the team only and is never sent to the customer. POST /messages with type Note.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "ticket_id",
        "text"
      ],
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 20000,
          "minLength": 1,
          "description": "The note text."
        },
        "ticket_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk ticket id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 22 lines
  • edesk_reply_to_ticket auth-required never probed

    WRITE, CUSTOMER-VISIBLE: send a reply on a ticket. eDesk queues it for delivery to the marketplace or email channel, so it cannot be recalled once queued. The audience is the channel's default: on a Mirakl channel it is the channel's "Default messages recipients" setting (customer, operator or both), and this API cannot choose recipients (use the eDesk reply box when they matter). Only call this when the user has approved the exact text and audience. If the call fails in transit, the reply may still be queued: check the ticket before retrying. Use edesk_add_ticket_note for an internal note. POST /messages with type Message.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "ticket_id",
        "text"
      ],
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 20000,
          "minLength": 1,
          "description": "The reply text the customer will receive."
        },
        "subject": {
          "type": "string",
          "maxLength": 500,
          "minLength": 1,
          "description": "Subject, for channels that use one (such as email)."
        },
        "ticket_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk ticket id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 28 lines
  • edesk_add_order_note auth-required never probed

    WRITE: add an internal note to a sales order (never sent to the customer). POST /order-notes.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "sales_order_id",
        "text"
      ],
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 20000,
          "minLength": 1,
          "description": "The note text."
        },
        "sales_order_id": {
          "type": "integer",
          "maximum": 9007199254740991,
          "description": "eDesk sales order id.",
          "exclusiveMinimum": 0
        }
      }
    }
    arguments 22 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 86cd9d3a346f7ca1.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/86cd9d3a346f7ca1/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/86cd9d3a346f7ca1/badge.svg)](https://brick.blue/agent/86cd9d3a346f7ca1?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on usefulapi.io 84 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

76 more sit on this domain. All of them.