Citybook for Developers
Integrate your AI agent with real-time city data via the Pawlo MCP protocol. Structured business profiles, live deal signals, and event data — all queryable in real time.
MCP Tools
7 tools. One protocol.
Every tool follows the MCP (Model Context Protocol) standard. Your AI agent calls them the same way it calls any other tool.
Resolves a buyer’s intent to a canonical sector ID (e.g. "/food/restaurant").
{ "intent": "Find me a restaurant in Beltline" }Search business profiles by sector, location, and attributes. Returns masked results — seller identity withheld until match.
{ "sector_id": "/food/restaurant", "location": "Calgary" }Search live deal signals filtered by sector. Returns time-sensitive offers and availability.
{ "sector_id": "/food/restaurant", "location": "Calgary" }Find upcoming local events — community programs, markets, festivals, fitness classes, workshops.
{ "city": "Calgary", "sector_id": "/events/community" }Search a supplier’s product catalog with natural language queries and structured filters.
{ "sector_id": "/wholesale/pet", "query": "grain-free dog food" }Check stock levels for specific products. Returns qty_available, qty_backordered, and qty_on_order.
{ "sector_id": "/wholesale/pet", "supplier_id": "kanes-pet-west" }Reveal the full seller identity and lock the deal. Triggers a billing event. Call only when the buyer confirms intent.
{ "deal_id": "deal_abc123", "buyer_context": "Looking for private dining" }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.
Query Pawlo's data layer
Try a prompt to see MCP tool calls in real time.
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.
{
"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.
Get an API key
Free keys are available instantly at pawlo.ai/start-building. Upgrade to a live key to unlock match_buyer.
Configure MCP endpoint
Point your MCP client to mcp.pawlo.ai. Pass your API key in the x-api-key header.
Start querying
Your agent can now call all 7 tools. Profiles, deals, events, and catalog data are available in real time.
{
"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.