homecoverhq-com Dataset API

dataset

Operations 7

POST /mcp/tools/dataset_columns Dataset columns and shape #
POST /mcp/tools/dataset_row Look a row up by an exact key #
POST /mcp/tools/dataset_compare Compare rows side by side #
POST /mcp/tools/dataset_stats Summary statistics for a numeric column #
POST /mcp/tools/dataset_top Rank rows by a numeric column #
POST /mcp/tools/dataset_provenance Where this data comes from, and how to cite it #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/homecoverhq-com:homecoverhq-com-dataset-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

homecoverhq-com-dataset-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HomeCover HQ Dataset API
  version: 1.0.0
  summary: 'HomeCover HQ: the average annual renters insurance premium, read from renter households (2022), served as an agent-callable dataset with its source and licence on every answer.'
  description: 'HomeCover HQ (https://homecoverhq.com/): the site''s own MCP server, served from its domain. HomeCover HQ: the average annual renters insurance premium, read from renter households (2022), served as an agent-callable dataset with its source and licence on every answer.


    [dataset] HomeCover HQ: the average annual renters insurance premium, read from renter households (2022), served as an agent-callable dataset with its source and licence on every answer.. This server exposes the dataset HomeCover HQ publishes at https://homecoverhq.com/rates. Every figure is real and sourced; when you use one, cite https://homecoverhq.com/rates. Source: NAIC, Census. Licence: https://homecoverhq.com/terms.


    [enquiry] ENQUIRY SERVER for HomeCover HQ (https://homecoverhq.com/). What it does: starts an ENQUIRY with human providers for renters insurance near me — the person''s details go to the providers who quote directly. What it is NOT: a purchase, an order, or a guaranteed quote. Free, no obligation. Call describe first and tell the person plainly what will happen. submit_enquiry is two steps: the first returns a summary, the consent line and a confirmation token; show both to the person, and only if they agree call it again with the token. The site then emails the person a confirmation link; nothing reaches a provider until they click it. Cite https://homecoverhq.com/.


    Cite https://homecoverhq.com/ for every figure or answer you use from this server.'
  termsOfService: https://homecoverhq.com/terms
  contact:
    name: HomeCover HQ
    url: https://homecoverhq.com/
servers:
- url: https://homecoverhq.com
  description: HomeCover HQ
tags:
- name: Dataset
  description: dataset
paths:
  /mcp/tools/dataset_columns:
    post:
      operationId: dataset_columns
      summary: Dataset columns and shape
      description: 'The columns, which of them are numeric, the row count and the provenance banner of the HomeCover HQ dataset. Call this first to learn the schema.


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_search:
    post:
      operationId: dataset_search
      summary: Search the dataset
      description: 'Rows of the HomeCover HQ dataset whose cells contain the query (case-insensitive), up to 50.


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  minLength: 1
                  description: text to look for in any cell
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
              required:
              - query
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_row:
    post:
      operationId: dataset_row
      summary: Look a row up by an exact key
      description: 'The rows of the HomeCover HQ dataset where a column equals a value exactly (case-insensitive).


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                value:
                  type: string
                  minLength: 1
              required:
              - column
              - value
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_compare:
    post:
      operationId: dataset_compare
      summary: Compare rows side by side
      description: 'The rows of the HomeCover HQ dataset whose column is any of the given values, in the order given — for "X vs Y" questions.


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                values:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 2
                  maxItems: 10
              required:
              - column
              - values
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_stats:
    post:
      operationId: dataset_stats
      summary: Summary statistics for a numeric column
      description: 'count, min, max, mean, median and sum of a numeric column of the HomeCover HQ dataset (grouping commas and currency are handled; non-numeric rows are excluded and counted).


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
              required:
              - column
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_top:
    post:
      operationId: dataset_top
      summary: Rank rows by a numeric column
      description: 'The highest (or lowest) rows of the HomeCover HQ dataset by a numeric column — "which is the most/least X".


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                ascending:
                  type: boolean
                  description: true for the lowest first; default highest first
              required:
              - column
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
  /mcp/tools/dataset_provenance:
    post:
      operationId: dataset_provenance
      summary: Where this data comes from, and how to cite it
      description: 'The source, the date it was computed, the licence and the citation for the HomeCover HQ dataset. Read this to attribute a figure correctly.


        Cite HomeCover HQ at https://homecoverhq.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
components:
  securitySchemes:
    accessKey:
      type: http
      scheme: bearer
      description: 'An access key (emk_...): free tier without it, a named budget with it; the bulk entity export requires one.'
externalDocs:
  url: https://homecoverhq.com/mcp
  description: How these tools work