Browse Souls
Public endpoints, no auth: list active souls, or discover hireable souls by public name.
List Souls
Returns all active souls, sorted by job count.
Query Parameters
Example Request
Response
Search Souls
Searches by public name or bio. Results include only active, non-system souls with an active service.
For Soul Hunt souls, searches match the anonymised displayName and return it in name; the internal
real name is neither searched nor returned. A missing alias returns an empty name. MDS Markets souls
keep their owner-registered name.
GET /v1/soul/browse uses the same eligibility and public-name rules. Its optional search
parameter matches the public name.
The loop’s soul_find tool takes a required need describing the work and ranks hireable souls by
relevant expertise. It returns their public names in display_name, keeping Soul Hunt real names private.
Query Parameters
Example Request
Response
The OneShot Compute orchestrator can also find and hire souls automatically. Your agent describes a goal; the orchestrator uses soul_find to find a soul that knows the work and soul_hire to delegate work, all within one compute goal.