---
title: "AreaOps Docs — API Reference, MCP Server, and Scoring Methodology"
description: "The AreaOps documentation index: developer portal, OpenAPI contract, MCP discovery, llms.txt, ZIP scoring methodology, and the vertical strategy guides."
url: https://areaops.app/docs
---
AreaOps Documentation

# AreaOps docs

AreaOps documentation is organised in four parts: how to build on the API, the files written for AI agents, how the ZIP scoring data works, and how operators use the product day to day. If you are wiring up an agent or writing code against AreaOps, start at the developer portal.

[Developer portal](/developers) [OpenAPI spec](/openapi.json)

## Build on AreaOps

Everything needed to call AreaOps from code or from an AI agent: authentication, the MCP tool catalogue, rate-limit conventions, and worked examples.

- [Developer portal](/developers) Quickstart, API-key authentication, MCP server setup, the CLI, endpoint reference, rate limits, and error codes.
- [OpenAPI 3.1 contract](/openapi.json) The machine-readable API description. Unique operationIds, typed parameters and response schemas — ready for LLM function calling.
- [MCP discovery document](/api/mcp/info) Public, unauthenticated description of the Model Context Protocol server and its 17 tools.
- [AreaOps for AI agents](/agents) What an agent can do with AreaOps, what stays behind human review, and where the data boundary sits.

## Agent instructions

Files written for machines rather than people. Point a crawler, an answer engine, or an agent's context loader at these.

- [llms.txt](/llms.txt) What AreaOps is, when an agent should reach for it, how to call it, and the citation-safe boundary on public data.
- [llms-full.txt](/llms-full.txt) Every public page inlined as one markdown document, for context loading in a single fetch.
- [agent-instructions.md](/agent-instructions.md) The when-to-use guidance on its own, as plain markdown.
- [Sitemap index](/sitemap-index.xml) Every indexable URL on the site, split into per-type child sitemaps.

## How the data works

The scoring model is documented in full — every source, every signal, every per-vertical weight. Nothing about a score is a black box.

- [Scoring methodology](/methodology) How a ZIP code gets a 0–100 targeting score: the Census ACS signals, the per-vertical weights, and the known limitations.
- [ZIP code targeting scores study](/data/zip-code-scores-for-home-services) The flagship data study, with a downloadable summary CSV.
- [Service area data index](/service-area-data) Entry point into the per-vertical, per-metro and per-ZIP data pages.

## Using the product

Strategy guides for the operators and agencies who run the territories AreaOps manages.

- [Vertical strategy guides](/guides/roofing-service-area-strategy) Eight guides — roofing, HVAC, plumbing, electrical, landscaping, pest control, windows & siding, gutters.
- [ZIP targeting for Google Local Services Ads](/zip-code-targeting-for-google-lsa) Turning scores into an LSA targeting list that does not burn budget on low-intent ZIPs.
- [Direct mail ZIP list builder](/direct-mail-zip-list-builder) Building a scored, filterable mailing list and exporting it to a mail vendor.
- [Pricing](/pricing) Plan, included seats, included agent units, and metered overage rates.

## Can't find what you need?

Documentation gaps are bugs. Tell us what you were looking for and we will either point you at it or write it.

[Contact AreaOps](/contact)