# pois.world

> Open map platform. Mark any place on Earth with photos, videos, and tags. Own virtual parcels. Pay with crypto (USDC/USDT on Polygon, Ethereum, Arbitrum, Base, BNB Chain, Tron).

## About

pois.world is an interactive world map with 1,000,000 ownable parcels. Users can:
- Create points of interest (POIs) at any location
- Add photos, videos, and tags to POIs
- Buy and own parcels for $1 USDC/USDT
- Explore nearby infrastructure (restaurants, shops, transit, etc.)
- View real-time updates from other users

## How to use

### Map navigation
- The main map is at /parcels/map (parcel view) and / (POI view)
- Click any parcel to see details
- Unowned parcels show "Available" badge and "Buy for $1.00" button
- Zoom with scroll wheel, pan by dragging

### Points of interest
- Create POIs at /pois/new or by clicking on the map
- Browse all POIs at /pois
- Each POI has coordinates, category, photos, videos, tags, comments
- POIs are searchable by category and tags

### Parcels
- 1,000,000 parcels cover the globe
- Each parcel has a unique number, style, and optional name
- Parcels can be merged (union) or split
- Parcel ownership is tracked on-chain

### Payments
- Buy parcels for $1 USDC or USDT
- Supported networks: Polygon, Ethereum, Arbitrum, Base, BNB Chain, Tron
- Payment is detected automatically via blockchain monitoring
- No account required to buy

## API

The REST API is at https://api.pois.world

### Key endpoints
- GET /v1/parcels/{gid} — parcel details
- GET /v1/parcels/{gid}/popup — parcel popup data with locations
- GET /v1/parcels/stats — total/sold/available counts
- GET /v1/parcels/by-point/?lat={lat}&lng={lng} — find parcel at coordinates
- GET /pois — list all POIs
- GET /pois/{id} — POI details with media
- POST /v1/payments/create — create payment (returns deposit address)
- GET /v1/payments/chains — list supported payment chains and tokens
- GET /v1/payments/monitor — blockchain monitor health status

## MCP Server (for AI agents)

pois.world provides a Model Context Protocol (MCP) server for AI agent integration.

- SSE endpoint: https://mcp.pois.world/sse
- Discovery: https://pois.world/.well-known/mcp.json
- Tools: search_pois, get_parcel, find_parcel_at, parcel_stats, nearby_infrastructure, payment_chains, buy_parcel, open_map

For Claude Desktop, add to ~/.claude/claude_desktop_config.json:
```json
{
  "mcpServers": {
    "pois-world": {
      "url": "https://mcp.pois.world/sse"
    }
  }
}
```

## Links

- [POI Map](https://pois.world/)
- [Parcel Map](https://pois.world/parcels/map)
- [Browse POIs](https://pois.world/pois)
- [Photos](https://pois.world/photos)
- [Videos](https://pois.world/videos)
- [Tags](https://pois.world/tags)
- [About](https://pois.world/about)