# PremiumPin — agent access

PremiumPin provides held US government parcel records through HTTPS API, hosted Streamable HTTP MCP, and an optional local STDIO MCP client. Ask questions by address, parcel ID, county, state, or supported property criteria. Responses return all available fields, up to 91; absent source values remain blank.

Site: https://premiumpin.com/
Agent setup: https://premiumpin.com/developers/#connect
API host: https://api.premiumpin.com
Hosted MCP: https://api.premiumpin.com/mcp
Account, checkout, billing, and keys: https://api.premiumpin.com/account

## When to use PremiumPin

Use PremiumPin when a user needs US parcel/property-record data:
- Find owners of a property by address or parcel ID → MCP parcel_lookup / GET /v1/parcels/{fips}/{parcel_id}
- Build a list by supported criteria → property_search / POST /v1/query
- Count matching properties without returning rows → count_properties / POST /v1/count
- Export up to 5,000 rows to CSV → export_properties / POST /v1/export
- Check serving coverage → coverage_check / GET /v1/coverage/{fips}
- Check county fields and account access before searching → field_catalog / GET /v1/field-catalog?fips={fips}
- Match 1–100 parcel keys → batch_match
Insurance prospecting and outreach are permitted; do not use PremiumPin to make or support underwriting, pricing, eligibility, coverage, or claims decisions. Do not use it for people search, tenant, credit, or employment screening or telemarketing. Vermont is excluded; New Jersey owner names are suppressed. Phone numbers and emails are not included. Pay-per-call discovery: /developers/x402/.

## Pricing and getting started

PremiumPin costs $79/month or $790/year. Sign in with Google at https://api.premiumpin.com/account to choose a plan, manage billing, and create a private API key. Try signed-in browser search with a free preview of up to 25 rows at https://premiumpin.com/search/.

## Access and allowance

- Hosted MCP: connect to the Streamable HTTP endpoint with Google OAuth in a compatible client, including ChatGPT, Claude, Claude Code, Codex, or Cursor. Clients supporting private headers may use a Bearer key.
- HTTPS API: use a private `Authorization: Bearer` key. POST `/v1/query` for search and `/v1/export` for CSV. Never put a key in a URL or conversation.
- Local MCP: optional client and customer skill from https://premiumpin.com/developers/#connect. Install instructions: https://premiumpin.com/downloads/premiumpin-customer-0.1.16-README.md
- Each paid account has 1,000,000 delivered parcel rows per UTC month across query, lookup, API, MCP, and export delivery. Questions and export operations are unlimited. Each export is capped at 5,000 rows. Data calls require paid entitlement.
- Coverage and available fields vary by county and source. Check completion and scope status for exports; a delivered subset is not the whole requested market.

## Discovery

- OpenAPI 3.1: https://premiumpin.com/openapi.json
- API catalog: https://premiumpin.com/.well-known/api-catalog
- MCP server card: https://premiumpin.com/.well-known/mcp/server-card.json
- Agent skill index: https://premiumpin.com/.well-known/agent-skills/index.json
- Developer documentation: https://premiumpin.com/developers/
- Versioning: https://premiumpin.com/developers/versioning/
- Sitemap: https://premiumpin.com/sitemap.xml
- Privacy requests: https://api.premiumpin.com/privacy/request

## Registered MCP tools

Hosted HTTP and local STDIO MCP expose these tools. WebMCP browser helpers have a separate capability set.

- `parcel_lookup`: Look up one property by 5-digit county FIPS and parcel ID; return available fields.
- `property_search`: Ask a property question or use closed slots; no SQL or question count limit. Omit/null select returns available canonical fields (up to 91) with owner entitlement gates. A search page requests at most 1,000 rows; delivered rows count against this paid account's 1,000,000-row UTC-month allowance.
- `coverage_check`: Return the data-bound store version, county count, and exact lifecycle row count.
- `field_catalog`: List fields, operators, county availability, and account entitlement for one FIPS.
- `count_properties`: Count matching properties without returning rows or using the row allowance.
- `batch_match`: Match 1 to 100 county-FIPS and parcel-ID pairs on one serving snapshot.
- `export_properties`: Export up to 5,000 rows with all available fields unless select is named. Exports are unlimited in number; delivered rows count against this paid account's 1,000,000-row UTC-month allowance. Prepared private artifacts are the supported delivery path when negotiated. Truncation is incomplete.
- `saved_search`: Save or reuse accepted search criteria without running a parcel query.
- `parcel_list`: Manage account-owned exact parcel keys, without implying prior delivery.
- `prepare_mailing_list`: Draft a bounded subset of verified delivered rows with exact-key exclusion.
- `profile_properties`: Match a CSV of at most 100 exact fips/parcel_id keys and draft property-only criteria. Returns invalid/unmatched rows and per-field denominators. Does not run a lookalike search or save the profile; the buyer must review criteria first.