---
title: "Get capability catalog"
method: GET
path: "/v1/capabilities"
tags: ["Metadata"]
---

# Get capability catalog

`GET /v1/capabilities`

## Request

- Base URL: `https://api.rateapi.dev`
- URL: `https://api.rateapi.dev/v1/capabilities`
- Auth: none required

Returns a machine-readable catalog of rateAPI's agent-buildable surface: each capability maps a real-world flow (institution discovery, rate shopping/comparison, affordability, refinance, monitoring/alerts, deposit/ALM) to the REST route an agent calls and the corresponding MCP tool, along with required/optional inputs and the minimum tier.

This is the foundation for an agent skills library. REST routes are derived from this OpenAPI spec, so the catalog cannot drift from the live API.

**No authentication required.**

## Response `200`

Capability catalog

- object
  - `version` integer: Schema version of this catalog.
  - `generatedAt` string, date-time: When this catalog was generated.
  - `flows` string[]: Every flow the capabilities are grouped into.
  - `count` integer: Number of capabilities in the catalog.
  - `capabilities` object[]: Every capability this API exposes, each as a REST route paired with its MCP tool.
    - `id` string: Stable slug for the capability.
    - `title` string: Short human-readable name.
    - `description` string: One line on what the capability does.
    - `flow` string: Which flow the capability belongs to.
    - `tier` 'Free' | 'Pro' | 'Enterprise': Minimum plan tier required to call it.
    - `route` object: The REST route that implements the capability, resolved from this OpenAPI spec by operationId.
      - `method` string: HTTP method of the route.
      - `path` string: Path of the route.
      - `operationId` string: The route’s operationId in this spec.
    - `mcpTool` string: Name of the MCP tool that calls the same route.
    - `inputs` object[]: The inputs the capability takes.
      - `name` string: Name of the input field.
      - `required` boolean: True when the call fails without it.
      - `unit` string: Unit or format the value is expected in — for example USD, a two-letter state code, an annual percentage, or months.
      - `description` string: What the input means.

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/rateapi/apis/rate-api.md) · [All operations](https://skmtc.dev/rateapi/apis/rate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rateapi/apis/rate-api/revisions/06a6db76995f?raw)