PApaywithlocus
Catalog

Search executable and requestable tools

REST counterpart to MCP search_apis. Returns compact ranked summaries and routes a selected result through /credits/tools/describe. Workspace and agent principals see enabled and requestable disabled tools by default; end-user-bound callers see enabled tools only, and an account setting may choose enabled-only discovery. Results honor key endpoint allowlists, agent-connection scopes, and end-user policies. Secret keys require tenant:read rather than credits:move. This operation does not call a provider or burn credits.

post/credits/tools/search

Request

  • Base URL
    https://api.paywithlocus.com/api
  • URL
    https://api.paywithlocus.com/api/credits/tools/search
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or HTTP bearer
    • or HTTP bearer

Headers

X-Locus-Session-Idstring

Required only when the end-user JWT carries sid. Send the original high-entropy session value; sid is its SHA-256 fingerprint. Ignored for secret-key authentication.

X-Locus-End-Userstring

Case-sensitive immutable ID in the tenant namespace. Prefer an identity-provider subject, not an email address.

Optional end-user identity for a tenant secret key.

Request body

querystring

Trimmed natural-language capability, provider, or tool query. Optional with category or pack.

categorystring

Live canonical category ID or unambiguous alias.

packstring

Live curated-pack ID or unambiguous alias.

limitinteger
cursorstring
include_facetsboolean

Response

Ranked compact tool summaries

successunknown required
querystring required
taxonomy_revisionstring required
appliedFiltersobject
countinteger required
next_cursorstring
facetsobject[]
notestring

Present when no enabled tool matched.

Changes

No recorded changes to this operation across all 1 revision of this API.