---
title: "Best currently available agent for a task under constraints"
method: POST
path: "/resolve"
tags: ["discovery"]
---

# Best currently available agent for a task under constraints

`POST /resolve`

## Request

- Base URL: `https://wellknown.network/api/v1`
- URL: `https://wellknown.network/api/v1/resolve`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- ResolveRequest
  - `need` string, required
  - `protocols` string[]
  - `capabilities` string[]
  - `requireLive` boolean
  - `remoteOnly` boolean
  - `claimedOnly` boolean
  - `maxPriceUsd` number
  - `limit` integer

## Response `200`

OK

- ResolveResponse
  - `need` string
  - `interpretation` object
  - `recommendation` object, nullable
    - `agent` string
    - `id` string
    - `endpoint` string, nullable
    - `confidence` 'observed' | 'unverified'
    - `basis` string
  - `candidates` object[]
    - `id` string
    - `handle` string
    - `name` string
    - `kind` 'agent' | 'mcp_server' | 'tool' | 'api'
    - `summary` string, nullable
    - `publisherName` string, nullable
    - `protocols` string[]
    - `categories` string[]
    - `status` 'live' | 'recently_observed' | 'unavailable' | 'unknown'
    - `statusReason` string, nullable
    - `lastObservedOkAt` string, date-time, nullable
    - `claimVerified` boolean
    - `primaryEndpointUrl` string, nullable: Network URL, or `npm:<name>` / `pypi:<name>` for local packages.
    - `capabilities` Capability[]
      - `slug` string
      - `name` string
      - `confidence` number
      - `provenance` 'declared' | 'derived' | 'claimed'
    - `pricing` object, nullable
    - `score` number
    - `signals` Signals: Transparent ranking components.
      - `lexical` number
      - `capability` number
      - `availability` number
      - `verification` number
      - `popularity` number
    - `callable` boolean
  - `relaxedConstraints` string[]

## Other responses

- `400`: Error
- `429`: Rate limited; see Retry-After and X-RateLimit-* headers.

---

[API](https://skmtc.dev/wellknown/apis/wellknown-api.md) · [All operations](https://skmtc.dev/wellknown/apis/wellknown-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wellknown/apis/wellknown-api/revisions/8a177fdcd434?raw)