# cityparity REST API API

**Canonical:** https://apis.io/apis/cityparity-com/cityparity-rest-api-api/  
**Provider:** cityparity — https://apis.io/providers/cityparity-com/  
**Base URL:** https://mcp.cityparity.com  
**Documentation:** https://cityparity.com/mcp/

cityparity REST API API is one of 2 APIs that [cityparity](https://apis.io/providers/cityparity-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

Cost-of-living and quality-of-life comparison endpoints. Same compute as the MCP server at /mcp; this surface is for non-MCP clients (web apps, scripts, integrations). All responses are JSON with shape { ok, data } on success or { ok: false, error, message } on failure.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/cities` | List all supported cities |
| GET | `/api/v1/cities/{slug}` | Get a city profile |
| GET | `/api/v1/cities/{slug}/inbound-regime` | Get inbound-worker tax regime for a city |
| POST | `/api/v1/compare` | Compare two cities for a household scenario |
| POST | `/api/v1/rank` | Rank cities by composite quality-of-life score |
| POST | `/api/v1/safety-net` | Get safety-net values for N cities |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/cityparity-com/openapi/_original/cityparity-com-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/cityparity-com/json-schema/cityparity-com-compare-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cityparity-com/json-schema/cityparity-com-rank-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cityparity-com/json-schema/cityparity-com-safety-net-request-schema.json

## Other cityparity APIs (1)

- [CityParity REST API](https://apis.io/apis/cityparity-com/cityparity-rest-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cityparity-com/cityparity-rest-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cityparity-com/.