terminalFor Developers

Build hallucination-free local experiences.

Your agent needs local data it can trust. Pawlo delivers structured business profiles, live signals, and events via MCP — verified by the businesses themselves, updated in real time.

Try the live demoarrow_downward Get an API key

MCP Tools

Every query type. One protocol.

Every tool follows the MCP (Model Context Protocol) standard. Your AI agent calls them the same way it calls any other tool.

category

resolve_sector_id

Resolves a buyer’s intent to a canonical sector ID (e.g. "/food/restaurant"). Covers 48 sectors across 14 verticals.

{ "intent": "Find me a restaurant in Beltline" }

storefront

fetch_profiles

Search business profiles by sector, location, and attributes. Open sectors return full identity; protected sectors (automotive, wholesale) mask the seller until match_buyer.

{ "sector_id": "/food/restaurant", "location": "Calgary" }

local_offer

fetch_deals

Search live deal signals filtered by sector. Returns time-sensitive offers and availability.

{ "sector_id": "/food/restaurant", "location": "Calgary" }

event

fetch_events

Find upcoming local events — community programs, markets, festivals, fitness classes, workshops.

{ "city": "Calgary", "sector_id": "/events/community" }

menu_book

fetch_menu

Fetch a restaurant’s full menu with dishes, prices, dietary tags, and allergens.

{ "sector_id": "/food/restaurant", "profile_id": "native-tongues" }

directions_car

fetch_inventory

Search vehicle inventory for automotive dealers. Returns make, model, year, trim, price, and availability.

{ "sector_id": "/automotive/new", "make": "Ford", "model": "Bronco" }

place

fetch_places

Discover businesses and attractions near a location. Returns hours, address, and sector-specific attributes.

{ "city": "Banff", "sector_id": "/hospitality/attraction" }

directions_run

fetch_activities

Find local activities and experiences — outdoor adventures, fitness classes, guided tours, seasonal programs.

{ "city": "Canmore", "query": "hiking with kids" }

inventory_2

fetch_catalog

Search a supplier’s product catalog with natural language queries and structured filters. Paid tier.

{ "sector_id": "/wholesale/pet", "query": "grain-free dog food" }

check_circle

fetch_availability

Check stock levels for specific products. Returns qty_available, qty_backordered, and qty_on_order. Paid tier.

{ "sector_id": "/wholesale/pet", "supplier_id": "kanes-pet-west" }

handshake

match_buyer

Reveal the full seller identity for protected sectors and lock the deal. Triggers a billing event. Call only when the buyer confirms intent. Paid tier.

{ "deal_id": "deal_abc123", "buyer_context": "Looking for private dining" }

notifications_active

Subscribe an agent to a sector or profile for persistent monitoring. Triggers fetch_notifications when new data arrives. Paid tier.

{ "sector_id": "/automotive/used", "query": "2024 Ford Bronco" }

inbox

fetch_notifications

Retrieve pending notifications for active follows. Returns new listings, inventory changes, and deal signals. Paid tier.

{ "agent_id": "agent_xyz" }

notifications_off

unfollow

Cancel an active follow subscription. Stops notifications and ends the recurring billing for that monitor. Paid tier.

{ "follow_id": "follow_abc123" }

Live Demo

See the tools in action.

This is a live demo querying real Calgary data through Pawlo's MCP tools. The sidebar shows every API call in real time.

pawlo-citybook

Query Pawlo's data layer

Try a prompt to see MCP tool calls in real time.

MCP Tools

build

Tool calls will appear here as the agent queries Pawlo's data layer.

Every query hits Pawlo's live database via MCP tools — the same infrastructure you integrate.

Data Model

Structured business profiles.

Every business in Citybook follows a standardized schema. Sector-specific attributes are layered on top of a common base — so your agent knows what fields to expect regardless of sector.

business-profile.json

{
  "sector_id": "/food/restaurant",
  "name": "Ten Foot Henry",
  "location": {
    "address": "1209 1 St SW",
    "city": "Calgary",
    "neighbourhood": "Beltline"
  },
  "attributes": {
    "cuisine": "Vegetable-forward sharing plates",
    "price_range": "$$$",
    "dietary": ["vegan menu", "gluten-free options"],
    "patio": { "dog_friendly": true, "heated": true },
    "private_dining": { "capacity": "8-12", "slots_available": 2 }
  },
  "signals": [
    {
      "type": "special",
      "text": "Seasonal tasting menu — $75/person",
      "valid_days": ["Tue", "Wed", "Thu"],
      "updated_at": "2026-03-01T09:00:00Z"
    }
  ]
}

Integration

Connect in minutes.

Point your MCP client at Pawlo's endpoint. Get an API key from the dashboard, and your agent can start querying immediately.

key

Get an API key

Free keys are available instantly at pawlo.ai/start-building. Free tier includes discovery, menus, events, and more. Paid tier unlocks match_buyer, follow, and catalog tools.

link

Configure MCP endpoint

Point your MCP client to mcp.pawlo.ai. Pass your API key in the x-api-key header.

rocket_launch

Start querying

Your agent can now call all tools. Profiles, deals, events, menus, inventory, and catalog data are available in real time.

mcp-config.json

{
  "mcpServers": {
    "pawlo": {
      "url": "https://mcp.pawlo.ai/sse",
      "headers": {
        "x-api-key": "pk_free_your_key_here"
      }
    }
  }
}

Start building with Citybook.

Free API keys are available now. Start querying real business data in minutes.

Start building →maileric@pawlo.ai