---
title: "Live-score an arbitrary agent URL"
method: POST
path: "/api/found-agent"
---

# Live-score an arbitrary agent URL

`POST /api/found-agent`

## Request

- Base URL: `https://agentsearch.luthersystems.com`
- URL: `https://agentsearch.luthersystems.com/api/found-agent`
- Auth: none declared
- TypeScript: <https://skmtc.dev/luthersystems/apis/agentsearch-http-api/docs/api/found-agent/post.ts> (a function with typed inputs; its response is checked against the schema)

Crawls + probes + LLM-scores any URL using the same rubric the batch pipeline uses. Useful for agents not in the index yet.

## Request body

- object
  - `url` string, uri, required
  - `name` string
  - `query` string

## Response `200`

Live-scored agent profile.

- AgentDetails
  - `name` string
  - `url` string
  - `description` string
  - `capabilities` string[]
  - `sources` string[]
  - `raw` object
  - `blocker` object
    - `status` 'alive' | 'dead' | 'timeout' | 'error'
    - `status_code` integer
    - `speed_ms` number
    - `eliminated` boolean
  - `scores` object
    - `fame` object
    - `usability` object
    - `functionality` object
    - `call_graph` number
    - `overall` number

---

[API](https://skmtc.dev/luthersystems/apis/agentsearch-http-api.md) - [All operations](https://skmtc.dev/luthersystems/apis/agentsearch-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luthersystems/apis/agentsearch-http-api/revisions/ef78c44edb95?raw)