# LiFoli Works Agent API Recipes

## Score AX Readiness

```http
POST /ax/scan
Content-Type: application/json

{
  "serviceUrl": "https://service.example.com/app",
  "signals": ["openapi", "oauth", "scoped_tokens"]
}
```

The response contains `score`, `route`, `permissionClass`, `missing`,
`nextAction`, `approvalRequired`, and `reasons`.

## Read MCP Manifest

```http
GET /mcp
```

The manifest describes the runtime stdio MCP export command:

```txt
pnpm --filter @lifoli/runtime mcp-export
```

Only read-safe capabilities with the `mcp_export` surface should be exposed.

## Discover Public Skills

```http
GET /.well-known/agent-skills/index.json
```

Each listed skill points to a reviewed `SKILL.md`. Do not assume unlisted local
skills are public or approved for external agent use.

## Run AX Spine Eval

```sh
pnpm --filter @lifoli/runtime eval:agent-experience-spine
```

The eval checks the route selector, seed workflow evals, PrintingPress fallback,
and approval ladder expectations.