# Pinloft by CyberMax

> Free geocoding API and MCP server: address to latitude/longitude with US Census county, tract and block FIPS codes, districts and reverse geocoding.

> Paid API keys from $19/month (Starter: 25,000 calls a month); free tier 100 calls a day per IP with no key. Buy: https://pinloft.cybermaxtools.com/buy/starter?s=lead · all plans: https://pinloft.cybermaxtools.com/docs#pricing

Type an address, get latitude and longitude, a cleaned address and, in the US, the county, Census tract and block FIPS codes from the official US Census geocoder. Worldwide addresses and reverse lookups use OpenStreetMap.

## API (free tier without a key; paid API keys for more)
- [/api/geocode](https://pinloft.cybermaxtools.com/api/geocode?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500): Geocode up to 5 addresses (US Census first, OpenStreetMap worldwide)
- [/api/reverse](https://pinloft.cybermaxtools.com/api/reverse?lat=40.7484&lon=-73.9857): Reverse geocode up to 5 points (street address + US FIPS and districts)
- GET for simple calls, POST a JSON body for lists. Same field names as the bulk version's dataset records.
- OpenAPI 3.1: https://pinloft.cybermaxtools.com/openapi.json

## MCP (remote, streamable HTTP, no auth)
- Endpoint: https://pinloft.cybermaxtools.com/mcp
- `geocode_address`: Convert up to 5 street addresses to latitude/longitude with a cleaned, matched address and match confidence. US addresses also get state, county, tract, block group and block FIPS codes (US Census geocoder); include_districts adds congressional and state legislative districts, city, school district and metro area. Worldwide addresses use OpenStreetMap.
- `reverse_geocode`: Convert up to 5 latitude/longitude points to the nearest street address (OpenStreetMap), and for US points add state/county/tract/block FIPS codes and congressional/state districts from the US Census geocoder.

## Limits
- 20 calls per minute per IP address.
- Up to 5 addresses or points per call.
- Up to 3 OpenStreetMap lookups per call (non-US addresses, US misses, reverse); US addresses use the Census geocoder.
- About 15 seconds per call at most.
- Free tier: 100 calls a day per IP, no key. Paid API keys from $19/month (or $5 pay-as-you-go) lift the daily limit. OSM results: © OpenStreetMap contributors (ODbL).

## More
- Health: https://pinloft.cybermaxtools.com/health
- All CyberMax tools: https://cybermax-tools-cybermax.static.hf.space/
- A bulk and scheduled version is coming to the Apify Store.

## Pricing
- Free: 100 calls a day per IP, 20/min, no key.
- Starter: $19/month, 25,000 calls a month, 60/min. Buy: https://pinloft.cybermaxtools.com/buy/starter?s=llms
- Pro: $49/month, 100,000 calls a month, 120/min. Buy: https://pinloft.cybermaxtools.com/buy/pro?s=llms
- Pay as you go: $5, 5,000 calls (one-time pack, no expiry), 60/min. Buy: https://pinloft.cybermaxtools.com/buy/pack?s=llms
- Starter yearly: $190/year, 25,000 calls a month, 60/min. Buy: https://pinloft.cybermaxtools.com/buy/starter-yearly?s=llms
- Pro yearly: $490/year, 100,000 calls a month, 120/min. Buy: https://pinloft.cybermaxtools.com/buy/pro-yearly?s=llms
- Use the key as `x-api-key: KEY` or `Authorization: Bearer KEY` (MCP too). Usage: https://pinloft.cybermaxtools.com/key. Machine-readable: https://pinloft.cybermaxtools.com/pricing.json

## Pay per call (x402, USDC on Base): for AI agents, no key, no account
- $0.002 per call, paid in USDC on Base (x402 "exact" scheme, v1 and v2).
- https://pinloft.cybermaxtools.com/x402/api/geocode: same as /api/geocode, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- https://pinloft.cybermaxtools.com/x402/api/reverse: same as /api/reverse, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- Plain endpoints keep the free tier and API keys; with no key, they also answer 402 (instead of 429) once the free daily quota is used.
- Send the signed payment as X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2); the receipt comes back in X-PAYMENT-RESPONSE / PAYMENT-RESPONSE. Failed calls are not charged.