Skip to main content
POST
List MCP servers

Restrictions

Usage

  • Pagination uses p/limit: p below 1 is treated as 1 and limit below 1 as 20. Results are ordered by name, then server ID, ascending.
  • Visibility follows real team membership for every caller, owner and admins included: account-scoped rows plus rows of teams the caller belongs to; team_ids entries outside that set are ignored.
  • scope=account returns only account-scoped rows; scope=team returns only team rows; all (default) returns team rows plus account-scoped rows unless include_account=false.
  • query performs a case-insensitive substring search across name, description, AI-generated description, server ID, transport, URL, command, and source template name.
  • The response never includes a live tool list; can_edit on each row tells whether the caller may change that server.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Pagination, scope, and search filters for listing MCP servers.

p
integer
default:1

Page number, 1-based; values below 1 are treated as 1.

limit
integer
default:20

Page size; values below 1 fall back to 20. No upper bound is enforced.

scope
enum<string>
default:all

Restrict results to a scope: account for account-wide rows only, team for the caller's own visible team rows only, or omit (defaults to all) for both, subject to team_ids/include_account.

Available options:
all,
account,
team
query
string

Case-insensitive substring search across name, description, AI-generated description, server ID, transport, URL, command, and source template name.

Maximum string length: 128
team_ids
integer<int64>[]

Restrict to these team IDs. IDs of teams the caller does not belong to are ignored; empty means all of the caller's teams.

include_account
boolean | null

Include account-scoped (team_id=0) rows. Defaults to true; ignored when scope is account (always included) or team (never included).

Response

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

Paginated MCP server list.