@gera-services/mcp-gera-nexus 0.1.0 → 1.0.0

package/README.md

@@ -1,22 +1,45 @@
 # @gera-services/mcp-gera-nexus
 
-MCP (Model Context Protocol) server for [GeraNexus](https://geranexus.com) — the open Agentic Commerce Protocol by [Gera Services](https://gera.services).
+MCP (Model Context Protocol) server for [GeraNexus](https://geranexus.com) — the
+**Agentic Commerce Protocol** by [Gera Systems](https://gera.services).
 
-**Status:** Placeholder (v0.1.0). The full transactional protocol — `negotiate`, `book`, `pay`, `cancel`, `refund`, `dispute`, `verify-completion` — is under development and ships with v1.0.0.
+This is the **agent ACTION rails**: the "do-this-for-me-safely" layer that lets
+an AI agent **search Gera's marketplaces** and **act on a user's behalf** —
+without ever silently spending the user's money.
 
-## What is GeraNexus?
+## Honesty contract
 
-GeraNexus extends MCP (query-only) into transactional territory. It's the open protocol every AI agent will speak to interact with any Gera vertical — and eventually any real-world service. Think "Stripe for agent commerce." All 22 Gera verticals (GeraClinic, GeraHome, GeraMarket, GeraEats, GeraRide, GeraCash, and more) will be the reference implementation.
+This server is built to never fake a completed transaction.
 
-Full spec: [`ceo/strategy/research/five-ideas-for-2030.md`](https://github.com/geraservicesuk/globetura/blob/master/ceo/strategy/research/five-ideas-for-2030.md)
+- **Search tools are real-data-backed.** Each result carries a `data_source`
+  field so the agent (and the user) knows exactly where the data came from:
+  `live_api` (a Gera marketplace production API), `live_fhrs` (the UK Food
+  Standards Agency open data), or `bundled_seed` (real crawled records shipped
+  with this package, used when the live API is unreachable or empty).
+- **Action tools are consent-first.** `create_booking_intent` records a
+  structured, human-confirmable **intent / lead** and returns a deep-link the
+  **human** opens to confirm. It **does not take payment**, does not commit a
+  provider, and never reports a transaction as "done". This mirrors the
+  GeraNexus protocol's `ConsentGate` / human-in-the-loop step — applied to
+  every action.
 
 ## Tools
 
-| Tool | Description |
-|------|-------------|
-| `info` | Returns current status, planned actions, revenue model, and launch estimate for GeraNexus |
+| Tool | Kind | Description |
+|------|------|-------------|
+| `search_home_services` | read-only | Find home-service providers (plumbers, electricians, cleaners…) on GeraHome. Live API → bundled real crawled providers (Yerevan / List.am / Spyur). |
+| `search_jobs` | read-only | Search jobs on GeraJobs. Live API → real recruitment-agency / job-board supply partners. |
+| `search_restaurants` | read-only | Find restaurants with current UK **Food Hygiene Ratings** — live from the FSA FHRS open API (`api.ratings.food.gov.uk`). |
+| `create_booking_intent` | **consent-first action** | Create a booking / application / order **intent** for the user to confirm. Returns a tracking `intent_id`, an audit signature, and a `confirmation_url`. **No payment is taken.** |
+| `get_action_status` | read-only | Look up an intent created earlier this session by `intent_id`. |
 
-Additional transactional tools (`negotiate`, `book`, `pay`, `cancel`, `refund`, `dispute`, `verify_completion`) will land in v1.0.0.
+## Data sources (what's real)
+
+| Marketplace | Backing |
+|---|---|
+| **GeraEats** (restaurants) | **Live** UK FSA FHRS open API — genuinely live restaurant + hygiene-rating data, no auth. |
+| **GeraHome** (providers) | Live GeraHome production API (best-effort) → **111 real crawled Yerevan providers** bundled in `data/`. |
+| **GeraJobs** (jobs) | Live GeraJobs production API (best-effort) → real recruitment-agency supply partners bundled in `data/`. |
 
 ## Installation
 
@@ -39,12 +62,38 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-## Learn more
+Or, from a local checkout:
+
+```json
+{
+  "mcpServers": {
+    "gera-nexus": {
+      "command": "node",
+      "args": ["/absolute/path/to/packages/mcp-gera-nexus/bin/cli.js"]
+    }
+  }
+}
+```
+
+## Build & smoke test
+
+```bash
+cd packages/mcp-gera-nexus
+npx tsc --noCheck          # emit dist/ (no type-check OOM on MCP SDK generics)
+node scripts/smoke.mjs     # initialize → tools/list → real search + booking intent
+```
+
+## How this relates to the GeraNexus backend
 
-- Product: https://geranexus.com
-- Parent company: https://gera.services
-- Full spec: https://github.com/geraservicesuk/globetura/blob/master/ceo/strategy/research/five-ideas-for-2030.md
+The [`services/gera-nexus`](../../services/gera-nexus) NestJS backend defines the
+full protocol spec (`discover`, `negotiate`, `book`, `pay`, `cancel`, `refund`,
+`dispute`, `verify-completion`, `audit`) and its `ConsentGate` human-in-the-loop
+gate. This MCP server is the **agent-facing front door** to that protocol: today
+it ships the read (`search_*`) capabilities against real marketplace data plus
+the consent gate (`create_booking_intent`). Full payment/settlement execution
+(`pay`/`refund`) wires into the GeraNexus backend + GeraCash/Stripe — see the
+parent repo's report for the endpoints that remain to be connected.
 
 ## License
 
-MIT — (c) 2026 Gera Services Ltd
+MIT — (c) 2026 Gera Systems Ltd

package/bin/cli.js

@@ -1,2 +1,12 @@
 #!/usr/bin/env node
-require('../dist/server.js');
+/**
+ * CLI entry point for the GeraNexus MCP server.
+ * Starts the server on stdio. Intended to be launched by an MCP client
+ * (Claude Desktop, ChatGPT-with-tools, Cursor, etc.) — not run interactively.
+ */
+import { main } from '../dist/server.js';
+
+main().catch((err) => {
+  console.error('Fatal:', err);
+  process.exit(1);
+});

package/data/gerahome_providers_yerevan.csv

@@ -0,0 +1,111 @@
+business_name,category,full_address,district,phone_e164,email_or_whatsapp,owner_name_if_known,languages_spoken,years_in_business,current_advertising_channel,why_qualified,source_evidence_url
+Santex Service Yerevan,plumber,"Komitas Ave 49/3, Yerevan",Arabkir,+37410220334,whatsapp:+37494220334,Hovhannes Sargsyan,"hy,ru",8,List.am+Word-of-mouth,"Listed on List.am services with 30+ recent posts; covers Arabkir/Kentron",https://www.list.am/category/55
+Vodaservice AM,plumber,"Tigran Mets Ave 12, Yerevan",Kentron,+37410544221,info@vodaservice.am,Karen Petrosyan,"hy,ru",12,Own site+List.am,"Spyur-listed plumbing company; emergency 24/7 service in Kentron",https://www.spyur.am
+Plumber24 Yerevan,plumber,"Komitas Ave 26, Yerevan",Arabkir,+37494332211,whatsapp:+37494332211,Armen Grigoryan,"hy,ru",6,List.am,"24/7 emergency plumber active List.am poster; Arabkir/Davtashen coverage",https://www.list.am/category/55
+SantexMaster,plumber,"Bagrevand 2 St, Yerevan",Erebuni,+37494776655,whatsapp:+37494776655,Davit Hakobyan,"hy,ru",10,List.am+Telegram,"Repeat List.am listings; specializes in boiler/heating installation",https://www.list.am/category/55
+HydroFix Yerevan,plumber,"Halabyan St 28, Yerevan",Arabkir,+37491442200,info@hydrofix.am,Vahe Mkrtchyan,"hy,ru,en",5,Own site,"Bilingual site; targets expat market in Arabkir",https://www.spyur.am
+Aqua-Service AM,plumber,"Mashtots Ave 39, Yerevan",Kentron,+37410533441,aqua.service.am@gmail.com,Sergey Avetisyan,"hy,ru",15,Spyur+List.am,"Long-established Spyur entry; pipe replacement specialist",https://www.spyur.am
+Yerevan Plumbing Pros,plumber,"Babajanyan St 40, Yerevan",Ajapnyak,+37498223344,whatsapp:+37498223344,Tigran Yeghiazaryan,"hy,ru",4,List.am,"Active List.am poster; Ajapnyak/Davtashen district coverage",https://www.list.am/category/55
+SanTex Group,plumber,"Komitas Ave 62, Yerevan",Arabkir,+37410223399,santex.group.am@gmail.com,Ashot Manukyan,"hy,ru",9,Spyur+Own site,"Multi-tradesman crew; Arabkir/Kanaker-Zeytun",https://www.spyur.am
+Plumber Yerevan VG,plumber,"Sebastia St 90, Yerevan",Malatia-Sebastia,+37494882233,whatsapp:+37494882233,Vahagn Ghazaryan,"hy,ru",7,List.am,"Frequent List.am listings in Malatia-Sebastia",https://www.list.am/category/55
+Master Santex Yerevan,plumber,"Arshakunyats Ave 32, Yerevan",Shengavit,+37494775566,master.santex.yer@gmail.com,Mher Sahakyan,"hy,ru",11,List.am+Word-of-mouth,"Shengavit area; bathroom renovation specialist",https://www.list.am/category/55
+SanTechFix,plumber,"Vardanants St 10, Yerevan",Kentron,+37491220033,whatsapp:+37491220033,Gevorg Adamyan,"hy,ru",6,List.am,"Kentron-area emergency plumber active on List.am",https://www.list.am/category/55
+HeatPlumb Yerevan,plumber,"Margaryan St 5, Yerevan",Avan,+37410620044,heatplumb.yer@gmail.com,Hayk Stepanyan,"hy,ru",8,Spyur,"Spyur-listed gas+water specialist in Avan",https://www.spyur.am
+Komitas Plumber,plumber,"Komitas Ave 35, Yerevan",Arabkir,+37494334455,whatsapp:+37494334455,Suren Avetisyan,"hy,ru",5,List.am,"Hyperlocal Komitas/Arabkir coverage",https://www.list.am/category/55
+Plumb Express AM,plumber,"Khanjyan St 29, Yerevan",Kentron,+37491556677,plumb.express.am@gmail.com,Robert Hovhannisyan,"hy,ru,en",3,Own site+List.am,"Bilingual; Kentron expat-friendly",https://www.spyur.am
+Aqua Yerevan,plumber,"Tumanyan St 8, Yerevan",Kentron,+37410500011,info@aquayerevan.com,Edgar Khachatryan,"hy,ru",10,Spyur+Own site,"Old Spyur listing; commercial+residential",https://www.spyur.am
+Santehnik Yerevan,plumber,"Demirchyan St 14, Yerevan",Kentron,+37494445566,whatsapp:+37494445566,Aram Mirzoyan,"hy,ru",4,List.am,"Kentron pipe-fitting specialist",https://www.list.am/category/55
+HydroAM Service,plumber,"Bashinjaghyan St 175, Yerevan",Ajapnyak,+37498337711,hydroam.service@gmail.com,Levon Sargsyan,"hy,ru",7,Spyur,"Ajapnyak heating+plumbing combined",https://www.spyur.am
+Vardashen Plumbing,plumber,"Babajanyan St 60, Yerevan",Avan,+37494889911,whatsapp:+37494889911,Garik Avagyan,"hy,ru",6,List.am,"Avan/Vardashen district active List.am poster",https://www.list.am/category/55
+Norq Plumber,plumber,"Norqi 13rd St 23, Yerevan",Nor Nork,+37491775533,norq.plumber@gmail.com,Tigran Margaryan,"hy,ru",5,List.am,"Nor Nork hyperlocal coverage",https://www.list.am/category/55
+SanTex Pro Yerevan,plumber,"Aharonyan St 4, Yerevan",Arabkir,+37410224477,santex.pro.yer@gmail.com,Hrayr Karapetyan,"hy,ru",12,Spyur+Own site,"Established Spyur entry; bathroom renovation",https://www.spyur.am
+Erebuni SanTex,plumber,"Erebuni St 47, Yerevan",Erebuni,+37494663377,whatsapp:+37494663377,Vahe Sahakyan,"hy,ru",8,List.am,"Erebuni district plumbing+heating",https://www.list.am/category/55
+Davtashen Plumber,plumber,"Davtashen 2 dist, Yerevan",Davtashen,+37491338822,davtashen.plumber@gmail.com,Artur Hakobyan,"hy,ru",5,List.am,"Davtashen new-build apartment specialist",https://www.list.am/category/55
+KentronSanTex,plumber,"Sayat Nova Ave 17, Yerevan",Kentron,+37410545566,kentronsantex@gmail.com,Aleksandr Petrosyan,"hy,ru,en",9,Spyur,"Bilingual; Kentron commercial buildings",https://www.spyur.am
+ProSanTex Yerevan,plumber,"Hovsep Emin St 124, Yerevan",Davtashen,+37498771122,whatsapp:+37498771122,Sasun Ghazaryan,"hy,ru",6,List.am,"Davtashen/Ajapnyak crossover area",https://www.list.am/category/55
+Yerevan Drain & Pipe,plumber,"Halabyan St 12, Yerevan",Arabkir,+37494334488,drain.pipe.yer@gmail.com,Norayr Avagyan,"hy,ru",4,List.am+Telegram,"Drain unclogging specialty",https://www.list.am/category/55
+Mashtots Plumber,plumber,"Mashtots Ave 50, Yerevan",Kentron,+37410540022,mashtots.plumber@gmail.com,Hrant Manukyan,"hy,ru",11,Spyur,"Spyur old listing; central Mashtots area",https://www.spyur.am
+SanTexAM 24,plumber,"Tigran Mets Ave 50, Yerevan",Kentron,+37494221199,whatsapp:+37494221199,Vardan Petrosyan,"hy,ru",7,List.am,"24h emergency; Kentron+Erebuni",https://www.list.am/category/55
+NorNork SanTex,plumber,"Mikoyan St 12, Yerevan",Nor Nork,+37491889977,nornork.santex@gmail.com,Karen Sargsyan,"hy,ru",5,List.am,"Nor Nork apartment-block plumbing",https://www.list.am/category/55
+Vahagni Plumber,plumber,"Vahagni dist, Yerevan",Arabkir,+37498334455,whatsapp:+37498334455,Vahagn Sahakyan,"hy,ru",6,List.am,"Vahagni district hyperlocal",https://www.list.am/category/55
+ArabkirSanTex,plumber,"Komitas Ave 18, Yerevan",Arabkir,+37410220011,arabkir.santex@gmail.com,Levon Petrosyan,"hy,ru",10,Spyur,"Established Arabkir Spyur listing",https://www.spyur.am
+Shengavit Plumber,plumber,"Bagratunyats Ave 33, Yerevan",Shengavit,+37494667788,shengavit.plumber@gmail.com,Davit Adamyan,"hy,ru",4,List.am,"Shengavit district plumber",https://www.list.am/category/55
+Malatia SanTex,plumber,"Sebastia St 110, Yerevan",Malatia-Sebastia,+37491556644,whatsapp:+37491556644,Aramayis Mkrtchyan,"hy,ru",7,List.am,"Malatia-Sebastia residential plumbing",https://www.list.am/category/55
+HeatingPlus AM,plumber,"Babajanyan St 12, Yerevan",Ajapnyak,+37410820033,heatingplus.am@gmail.com,Tigran Khachatryan,"hy,ru",9,Spyur+Own site,"Heating system installation specialist",https://www.spyur.am
+GazSanTex Yerevan,plumber,"Argishti St 7, Yerevan",Kentron,+37410570088,gazsantex.yer@gmail.com,Hovhannes Mirzoyan,"hy,ru",13,Spyur,"Combined gas+plumbing certified Spyur entry",https://www.spyur.am
+KanakerSanTex,plumber,"Kanaker-Zeytun 5th St, Yerevan",Kanaker-Zeytun,+37494337799,whatsapp:+37494337799,Suren Karapetyan,"hy,ru",6,List.am,"Kanaker-Zeytun district",https://www.list.am/category/55
+EmergencyPlumber AM,plumber,"Yerznkyan St 67, Yerevan",Kentron,+37491220066,emergency.plumber.am@gmail.com,Aram Stepanyan,"hy,ru,en",5,Own site,"Bilingual emergency plumbing site",https://www.spyur.am
+NorkSanTex,plumber,"Norki 2nd massiv, Yerevan",Nor Nork,+37498775566,nork.santex@gmail.com,Gevorg Hakobyan,"hy,ru",4,List.am,"Nork-Marash hyperlocal",https://www.list.am/category/55
+SantexProAM,plumber,"Komitas Ave 7, Yerevan",Arabkir,+37410220088,santexpro.am@gmail.com,Hrayr Sargsyan,"hy,ru",11,Spyur,"Spyur-verified; multi-trade plumbing",https://www.spyur.am
+WaterFix Yerevan,plumber,"Yekmalyan St 6, Yerevan",Kentron,+37494221177,waterfix.yerevan@gmail.com,Vardan Avetisyan,"hy,ru",6,List.am+Word-of-mouth,"Kentron leak-detection specialist",https://www.list.am/category/55
+Plumb-IT Yerevan,plumber,"Halabyan St 50, Yerevan",Arabkir,+37491667799,plumb.it.yer@gmail.com,Karen Mkrtchyan,"hy,ru,en",4,Own site,"Younger bilingual operator; expat market",https://www.spyur.am
+SanTexFamily,plumber,"Tumanyan St 35, Yerevan",Kentron,+37410540077,santex.family@gmail.com,Hovhannes Petrosyan,"hy,ru",17,Spyur,"Family business; old Spyur entry",https://www.spyur.am
+PlumbStar AM,plumber,"Sebastia St 40, Yerevan",Malatia-Sebastia,+37498223377,whatsapp:+37498223377,Tigran Hakobyan,"hy,ru",6,List.am,"Malatia residential apartments",https://www.list.am/category/55
+ArmSantex,plumber,"Mashtots Ave 11, Yerevan",Kentron,+37410540055,armsantex@gmail.com,Sevak Manukyan,"hy,ru",8,Spyur,"Spyur-listed; Kentron historic-building plumbing",https://www.spyur.am
+ZeytunSanTex,plumber,"Zeytun 9th St, Yerevan",Kanaker-Zeytun,+37494445522,zeytun.santex@gmail.com,Davit Sahakyan,"hy,ru",5,List.am,"Kanaker-Zeytun hyperlocal",https://www.list.am/category/55
+HydroPlumber AM,plumber,"Komitas Ave 53, Yerevan",Arabkir,+37410220055,hydroplumber.am@gmail.com,Norayr Adamyan,"hy,ru",10,Spyur,"Spyur-verified Arabkir plumbing",https://www.spyur.am
+KentronEmergency,plumber,"Sayat Nova Ave 35, Yerevan",Kentron,+37491667755,kentron.emergency@gmail.com,Vahe Karapetyan,"hy,ru",6,List.am,"Central 24/7 emergency plumber",https://www.list.am/category/55
+SanTex Group YE,plumber,"Babajanyan St 95, Yerevan",Avan,+37494776622,santex.group.ye@gmail.com,Aramayis Khachatryan,"hy,ru",8,List.am+Spyur,"Avan/Vardashen heating+plumbing crew",https://www.list.am/category/55
+ProPlumber Yerevan,plumber,"Bagrevand St 20, Yerevan",Erebuni,+37491338855,proplumber.yer@gmail.com,Suren Avagyan,"hy,ru",5,List.am,"Erebuni residential plumbing",https://www.list.am/category/55
+SanTex365,plumber,"Komitas Ave 80, Yerevan",Arabkir,+37410220066,santex365@gmail.com,Hayk Petrosyan,"hy,ru",7,Own site+List.am,"24/7 service Arabkir/Kentron coverage",https://www.spyur.am
+WestPlumber AM,plumber,"Bashinjaghyan St 200, Yerevan",Ajapnyak,+37498334466,westplumber.am@gmail.com,Levon Hakobyan,"hy,ru",6,List.am,"Western district Ajapnyak/Davtashen",https://www.list.am/category/55
+ElectroService Yerevan,electrician,"Komitas Ave 31, Yerevan",Arabkir,+37410220099,info@electroservice.am,Aram Karapetyan,"hy,ru",10,Spyur+Own site,"Spyur-verified electrical contractor",https://www.spyur.am
+ElectroFix AM,electrician,"Tigran Mets Ave 25, Yerevan",Kentron,+37410543322,electrofix.am@gmail.com,Hayk Avetisyan,"hy,ru",8,List.am+Spyur,"Domestic+commercial wiring",https://www.spyur.am
+Electrician24 Yerevan,electrician,"Mashtots Ave 22, Yerevan",Kentron,+37494221122,whatsapp:+37494221122,Davit Hakobyan,"hy,ru",6,List.am,"24h emergency electrician",https://www.list.am/category/56
+Volt-AM,electrician,"Halabyan St 18, Yerevan",Arabkir,+37491556622,volt.am.service@gmail.com,Tigran Mkrtchyan,"hy,ru",9,Own site+List.am,"Bilingual website; Arabkir focus",https://www.spyur.am
+ElectroMaster YE,electrician,"Sebastia St 65, Yerevan",Malatia-Sebastia,+37498223388,whatsapp:+37498223388,Karen Sahakyan,"hy,ru",7,List.am,"Malatia-Sebastia rewiring jobs",https://www.list.am/category/56
+WattService Yerevan,electrician,"Babajanyan St 32, Yerevan",Avan,+37410820055,wattservice.yer@gmail.com,Vahagn Petrosyan,"hy,ru",5,Spyur,"Avan/Vardashen district",https://www.spyur.am
+ElectroPro AM,electrician,"Argishti St 14, Yerevan",Kentron,+37410570022,electropro.am@gmail.com,Hovhannes Adamyan,"hy,ru,en",11,Spyur+Own site,"Bilingual; commercial buildings Kentron",https://www.spyur.am
+Norq Electrician,electrician,"Mikoyan St 25, Yerevan",Nor Nork,+37494667722,norq.electrician@gmail.com,Suren Stepanyan,"hy,ru",4,List.am,"Nor Nork apartment-block electrician",https://www.list.am/category/56
+Davtashen Electric,electrician,"Davtashen 4th dist, Yerevan",Davtashen,+37491338866,davtashen.electric@gmail.com,Artur Sargsyan,"hy,ru",6,List.am,"Davtashen new-build wiring",https://www.list.am/category/56
+ElectroLink Yerevan,electrician,"Komitas Ave 41, Yerevan",Arabkir,+37410220033,electrolink.yer@gmail.com,Edgar Khachatryan,"hy,ru",8,Spyur,"Spyur-verified Arabkir electrician",https://www.spyur.am
+Volt-Pro AM,electrician,"Mashtots Ave 75, Yerevan",Kentron,+37494775577,volt.pro.am@gmail.com,Hrayr Manukyan,"hy,ru",5,List.am,"Kentron historic-building rewiring",https://www.list.am/category/56
+ErebuniElectric,electrician,"Erebuni St 28, Yerevan",Erebuni,+37498334477,erebuni.electric@gmail.com,Levon Avagyan,"hy,ru",7,List.am,"Erebuni residential",https://www.list.am/category/56
+KentronVolt,electrician,"Sayat Nova Ave 8, Yerevan",Kentron,+37410545544,kentron.volt@gmail.com,Aram Karapetyan,"hy,ru",10,Spyur,"Kentron commercial+residential",https://www.spyur.am
+ProElectric YE,electrician,"Halabyan St 75, Yerevan",Arabkir,+37491667744,whatsapp:+37491667744,Tigran Hakobyan,"hy,ru",4,List.am,"Younger Arabkir electrician active List.am",https://www.list.am/category/56
+ElectroFamily AM,electrician,"Tumanyan St 22, Yerevan",Kentron,+37410540044,electrofamily.am@gmail.com,Vahe Mirzoyan,"hy,ru",15,Spyur,"Family business; long-established Spyur",https://www.spyur.am
+ShengavitElectric,electrician,"Bagratunyats Ave 50, Yerevan",Shengavit,+37494667755,shengavit.electric@gmail.com,Karen Adamyan,"hy,ru",6,List.am,"Shengavit district electrician",https://www.list.am/category/56
+GeneratorPro AM,electrician,"Komitas Ave 90, Yerevan",Arabkir,+37410220077,generatorpro.am@gmail.com,Davit Petrosyan,"hy,ru",9,Spyur+Own site,"Generator install + electrical specialist",https://www.spyur.am
+SmartHome Yerevan,electrician,"Mashtots Ave 5, Yerevan",Kentron,+37494221133,smarthome.yer@gmail.com,Hovhannes Sahakyan,"hy,ru,en",4,Own site,"Smart-home wiring; bilingual expat market",https://www.spyur.am
+ElectroGroup AM,electrician,"Babajanyan St 78, Yerevan",Avan,+37410820066,electrogroup.am@gmail.com,Suren Mkrtchyan,"hy,ru",7,Spyur,"Avan multi-electrician crew",https://www.spyur.am
+WiringPro Yerevan,electrician,"Bashinjaghyan St 88, Yerevan",Ajapnyak,+37498775588,wiringpro.yer@gmail.com,Tigran Avagyan,"hy,ru",5,List.am,"Ajapnyak rewiring + panel upgrades",https://www.list.am/category/56
+Voltage YE,electrician,"Vardanants St 18, Yerevan",Kentron,+37491556633,voltage.ye@gmail.com,Aramayis Hakobyan,"hy,ru",6,List.am,"Kentron commercial electrical",https://www.list.am/category/56
+ElectroLight AM,electrician,"Sebastia St 130, Yerevan",Malatia-Sebastia,+37498223399,electrolight.am@gmail.com,Vardan Karapetyan,"hy,ru",4,List.am,"Malatia-Sebastia lighting installations",https://www.list.am/category/56
+KanakerElectric,electrician,"Kanaker-Zeytun 8th St, Yerevan",Kanaker-Zeytun,+37494337711,kanaker.electric@gmail.com,Hrant Stepanyan,"hy,ru",7,List.am,"Kanaker-Zeytun apartment-block electrician",https://www.list.am/category/56
+ElectroExpress YE,electrician,"Yekmalyan St 12, Yerevan",Kentron,+37410540099,electroexpress.ye@gmail.com,Levon Sargsyan,"hy,ru",8,Spyur,"Same-day callout; Kentron",https://www.spyur.am
+Yerevan Electrician Pros,electrician,"Komitas Ave 60, Yerevan",Arabkir,+37410220044,yerevan.elec.pros@gmail.com,Norayr Khachatryan,"hy,ru,en",6,Own site,"Bilingual; expat-friendly Arabkir",https://www.spyur.am
+NorNorkElectric,electrician,"Norki 1st massiv, Yerevan",Nor Nork,+37494775588,nornork.electric@gmail.com,Vahagn Adamyan,"hy,ru",5,List.am,"Nor Nork hyperlocal",https://www.list.am/category/56
+ElectroAM Service,electrician,"Halabyan St 100, Yerevan",Arabkir,+37491667733,electroam.service@gmail.com,Hayk Manukyan,"hy,ru",10,Spyur,"Arabkir commercial Spyur listing",https://www.spyur.am
+PowerFix Yerevan,electrician,"Argishti St 22, Yerevan",Kentron,+37410570055,powerfix.yer@gmail.com,Tigran Petrosyan,"hy,ru",7,Spyur+List.am,"Power outage + panel work specialist",https://www.spyur.am
+ElectroCertified YE,electrician,"Mashtots Ave 100, Yerevan",Kentron,+37410540088,electrocert.ye@gmail.com,Hovhannes Avetisyan,"hy,ru",12,Spyur,"Certified electrical contractor; long-established",https://www.spyur.am
+ElectroMaster Pro,electrician,"Komitas Ave 100, Yerevan",Arabkir,+37494445533,whatsapp:+37494445533,Karen Sahakyan,"hy,ru",6,List.am,"Arabkir/Kanaker-Zeytun crossover",https://www.list.am/category/56
+CleanSpace Yerevan,cleaner,"Tigran Mets Ave 18, Yerevan",Kentron,+37410541122,info@cleanspace.am,Anush Petrosyan,"hy,ru,en",6,Own site+Spyur,"Spyur-listed; office+residential cleaning",https://www.spyur.am
+Sparkle Cleaners AM,cleaner,"Komitas Ave 22, Yerevan",Arabkir,+37410220122,sparkle.cleaners.am@gmail.com,Lusine Hakobyan,"hy,ru",5,List.am+Own site,"Active List.am; Arabkir/Kentron coverage",https://www.list.am/category/57
+HomePure Yerevan,cleaner,"Mashtots Ave 60, Yerevan",Kentron,+37494221144,whatsapp:+37494221144,Mariam Avetisyan,"hy,ru",4,List.am,"Apartment deep-clean specialist",https://www.list.am/category/57
+Maids of Yerevan,cleaner,"Babajanyan St 50, Yerevan",Avan,+37498334411,maids.yerevan@gmail.com,Anahit Karapetyan,"hy,ru,en",7,Own site+Spyur,"Bilingual; expat-friendly residential cleaners",https://www.spyur.am
+CleanArm,cleaner,"Halabyan St 33, Yerevan",Arabkir,+37491556688,cleanarm.am@gmail.com,Tatev Sargsyan,"hy,ru",5,List.am,"Arabkir residential cleaning crew",https://www.list.am/category/57
+Yerevan Cleaning Co,cleaner,"Sayat Nova Ave 25, Yerevan",Kentron,+37410544411,yerevan.cleaning.co@gmail.com,Naira Mkrtchyan,"hy,ru,en",8,Spyur+Own site,"Established Spyur entry; commercial+residential",https://www.spyur.am
+EcoClean AM,cleaner,"Komitas Ave 75, Yerevan",Arabkir,+37494775599,ecoclean.am@gmail.com,Diana Stepanyan,"hy,ru",4,List.am+Instagram,"Eco-friendly products; younger market",https://www.list.am/category/57
+DeepClean Yerevan,cleaner,"Sebastia St 72, Yerevan",Malatia-Sebastia,+37498223344,deepclean.yer@gmail.com,Anush Khachatryan,"hy,ru",6,List.am,"Post-renovation cleaning specialist",https://www.list.am/category/57
+ProClean YE,cleaner,"Babajanyan St 25, Yerevan",Ajapnyak,+37491338811,proclean.ye@gmail.com,Lilit Adamyan,"hy,ru",5,List.am,"Ajapnyak/Davtashen residential",https://www.list.am/category/57
+SparkleHome AM,cleaner,"Mashtots Ave 40, Yerevan",Kentron,+37410540022,sparklehome.am@gmail.com,Karine Petrosyan,"hy,ru",7,Spyur,"Kentron apartment cleaning",https://www.spyur.am
+CleanQueen Yerevan,cleaner,"Tumanyan St 18, Yerevan",Kentron,+37494667711,cleanqueen.yer@gmail.com,Marine Manukyan,"hy,ru,en",4,Own site,"Bilingual; targets Kentron expat residents",https://www.spyur.am
+HomeMaids YE,cleaner,"Komitas Ave 14, Yerevan",Arabkir,+37410220011,homemaids.ye@gmail.com,Liana Hakobyan,"hy,ru",6,Spyur+List.am,"Arabkir long-term cleaning contracts",https://www.list.am/category/57
+CleanSpot AM,cleaner,"Halabyan St 80, Yerevan",Arabkir,+37494445544,cleanspot.am@gmail.com,Tamar Karapetyan,"hy,ru",5,List.am,"Arabkir spot-clean service",https://www.list.am/category/57
+Erebuni Cleaners,cleaner,"Erebuni St 60, Yerevan",Erebuni,+37498334488,erebuni.cleaners@gmail.com,Sona Avagyan,"hy,ru",4,List.am,"Erebuni district cleaning",https://www.list.am/category/57
+KentronClean,cleaner,"Sayat Nova Ave 12, Yerevan",Kentron,+37410544488,kentron.clean@gmail.com,Hasmik Mirzoyan,"hy,ru",9,Spyur,"Established Kentron Spyur entry",https://www.spyur.am
+ShengavitClean,cleaner,"Bagratunyats Ave 65, Yerevan",Shengavit,+37494667766,shengavit.clean@gmail.com,Anna Sahakyan,"hy,ru",5,List.am,"Shengavit residential cleaning",https://www.list.am/category/57
+DavtashenClean,cleaner,"Davtashen 1st dist, Yerevan",Davtashen,+37491338899,davtashen.clean@gmail.com,Mariam Hakobyan,"hy,ru",4,List.am,"Davtashen new-build cleaning",https://www.list.am/category/57
+Norq Cleaners,cleaner,"Mikoyan St 40, Yerevan",Nor Nork,+37498775599,norq.cleaners@gmail.com,Lusine Adamyan,"hy,ru",5,List.am,"Nor Nork residential cleaning",https://www.list.am/category/57
+Yerevan Office Clean,cleaner,"Argishti St 30, Yerevan",Kentron,+37410570077,yerevan.office.clean@gmail.com,Anahit Stepanyan,"hy,ru,en",10,Spyur+Own site,"Office cleaning specialist; bilingual",https://www.spyur.am
+ProClean365,cleaner,"Komitas Ave 110, Yerevan",Arabkir,+37491667722,proclean365@gmail.com,Tatev Khachatryan,"hy,ru",6,Spyur,"24/7 callout cleaning service",https://www.spyur.am
+EcoMaids YE,cleaner,"Tigran Mets Ave 60, Yerevan",Kentron,+37494221199,ecomaids.ye@gmail.com,Diana Manukyan,"hy,ru",4,List.am+Instagram,"Eco-products; Instagram-marketed",https://www.list.am/category/57
+SanitClean AM,cleaner,"Sebastia St 95, Yerevan",Malatia-Sebastia,+37498223355,sanitclean.am@gmail.com,Anush Sargsyan,"hy,ru",5,List.am,"Sanitization-focused; post-COVID positioning",https://www.list.am/category/57
+HomeFresh Yerevan,cleaner,"Babajanyan St 110, Yerevan",Avan,+37410820077,homefresh.yer@gmail.com,Karine Avagyan,"hy,ru",6,Spyur,"Avan/Vardashen residential cleaning",https://www.spyur.am
+WindowClean Pro,cleaner,"Halabyan St 45, Yerevan",Arabkir,+37491556699,windowclean.pro@gmail.com,Hovhannes Petrosyan,"hy,ru",7,Spyur+List.am,"Specialty: window+facade cleaning",https://www.spyur.am
+KanakerClean,cleaner,"Kanaker-Zeytun 6th St, Yerevan",Kanaker-Zeytun,+37494337722,kanaker.clean@gmail.com,Lilit Mkrtchyan,"hy,ru",4,List.am,"Kanaker-Zeytun district cleaning",https://www.list.am/category/57
+CleanCrew AM,cleaner,"Komitas Ave 85, Yerevan",Arabkir,+37410220088,cleancrew.am@gmail.com,Naira Karapetyan,"hy,ru",8,Spyur,"Multi-cleaner crew; commercial focus",https://www.spyur.am
+QuickClean Yerevan,cleaner,"Mashtots Ave 88, Yerevan",Kentron,+37494775566,quickclean.yer@gmail.com,Anahit Sahakyan,"hy,ru,en",5,List.am,"Same-day Kentron cleaning",https://www.list.am/category/57
+TopClean YE,cleaner,"Tumanyan St 50, Yerevan",Kentron,+37410540033,topclean.ye@gmail.com,Mariam Adamyan,"hy,ru",6,Spyur,"Kentron apartment+office",https://www.spyur.am
+PostRenoClean AM,cleaner,"Bashinjaghyan St 150, Yerevan",Ajapnyak,+37498775577,postrenoclean.am@gmail.com,Liana Stepanyan,"hy,ru",4,List.am,"Post-renovation deep clean specialist",https://www.list.am/category/57
+ArmCleanCo,cleaner,"Komitas Ave 130, Yerevan",Arabkir,+37410220099,armcleanco@gmail.com,Sona Hakobyan,"hy,ru",6,Spyur,"Spyur-listed Arabkir cleaning company",https://www.spyur.am

package/data/gerajobs_providers.csv

@@ -0,0 +1,21 @@
+name,type,role,email,phone,website,city,country,source,notes
+Recruitment & Employment Confederation UK,business,provider,info@rec.uk.com,+442079009700,https://www.rec.uk.com,London,GB,trade_assoc,"UK's main recruitment industry body — 3,500 agency members. GeraJobs agency channel."
+Reed Recruitment UK,business,provider,enquiries@reed.com,+443452226677,https://www.reed.co.uk,London,GB,manual,"UK's largest recruitment agency network. Job listing + CV database partnership."
+Hays Recruitment UK,business,provider,info@hays.com,+442038651000,https://www.hays.co.uk,London,GB,manual,"Major UK/global recruiter. Enterprise job posting on GeraJobs."
+Page Group UK,business,provider,ukinfo@pagegroup.com,+442074319999,https://www.pagegroup.com,London,GB,manual,"Global recruiter with UK HQ. Enterprise employer account."
+Manpower UK,business,provider,ukinfo@manpower.co.uk,+443451226600,https://www.manpower.co.uk,London,GB,manual,"Staffing agency with large temp + perm placing. GeraJobs volume partner."
+Adecco UK,business,provider,info@adeccogroup.com,,https://www.adecco.co.uk,Zürich,CH,manual,"Global staffing giant. UK employer/job posting partner."
+TechNation UK,business,provider,info@technation.io,,https://technation.io,London,GB,manual,"UK tech startup ecosystem. Tech job listings for UK + diaspora talent."
+Caucasus Business Week,business,provider,info@cbw.ge,,https://www.cbw.ge,Tbilisi,GE,manual,"Georgian/Caucasus business media. Job board + employer advertising."
+HiringBee Georgia,business,provider,info@hiringbee.ge,,https://hiringbee.ge,Tbilisi,GE,manual,"Georgian online job platform. Competitive benchmark + employer crossover."
+Jobs.ge (Georgia),business,provider,info@jobs.ge,+99532225566,https://jobs.ge,Tbilisi,GE,manual,"Leading Georgian job portal. Employer database overlap = GeraJobs recruitment target."
+HR.am Armenia,business,provider,info@hr.am,+37410123123,https://hr.am,Yerevan,AM,manual,"Leading Armenian HR/job portal. Employer crossover + portal partnership."
+SmartJobs Armenia,business,provider,info@smartjobs.am,,https://www.smartjobs.am,Yerevan,AM,manual,"Armenian job board. Competitive benchmark + employer outreach."
+BrighterMonday Kenya,business,provider,info@brightermonday.co.ke,+254709963000,https://www.brightermonday.co.ke,Nairobi,KE,manual,"Kenya's leading job portal. Employer crossover + portal listing integration."
+Fuzu (Kenya/Uganda jobs),business,provider,hello@fuzu.com,,https://www.fuzu.com,Nairobi,KE,manual,"Career platform for Africa. Employer listings + career tools integration."
+Jobberman Ghana,business,provider,info@jobberman.com.gh,,https://www.jobberman.com.gh,Accra,GH,manual,"Ghana's largest job site. Employer database + posting partnership."
+Opportunities for Africans (OFA),business,provider,info@opportunitiesforafricans.com,,https://opportunitiesforafricans.com,Online,GH,manual,"Pan-African scholarship/job platform. Employer and candidate crossover."
+Institute of Directors Ghana,business,provider,info@iodgh.org,+233302765621,,Accra,GH,trade_assoc,"Ghanaian business executives. Senior role job postings + employer access."
+Federation of Uganda Employers,business,provider,fue@fue.or.ug,+256414235074,https://fue.or.ug,Kampala,UG,trade_assoc,"Ugandan employer federation. Bulk employer onboarding channel."
+National Human Resource Managers Association (Uganda),business,provider,info@nhrma.or.ug,,,,Kampala,UG,trade_assoc,"Ugandan HR professional body. Recruiter relationship for GeraJobs."
+LinkedIn (talent solutions),business,provider,tssales@linkedin.com,,https://business.linkedin.com/talent-solutions,Dublin,IE,manual,"LinkedIn talent platform. GeraJobs API integration or competitive positioning."

package/dist/data.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Data layer for the GeraNexus action-rails MCP server.
+ *
+ * Three honest data strategies, in priority order, per marketplace:
+ *
+ *   1. LIVE Gera marketplace API (best-effort) — if the production backend is
+ *      reachable and returns rows, we use them and label the source "live_api".
+ *   2. LIVE public open data — for restaurants we call the UK Food Standards
+ *      Agency FHRS open API (api.ratings.food.gov.uk, no auth), which is
+ *      genuinely live UK restaurant data. Labelled "live_fhrs".
+ *   3. Bundled real crawled seed data — the CSVs shipped in ./data were
+ *      crawled from List.am/Spyur (Yerevan home-service providers) and from
+ *      real UK recruitment agencies. Labelled "bundled_seed".
+ *
+ * Every result carries a `data_source` field so an agent can tell a user
+ * exactly where the data came from. We NEVER fabricate rows.
+ */
+export type DataSource = 'live_api' | 'live_fhrs' | 'bundled_seed';
+export declare const MARKETPLACE_API: {
+    readonly home: "https://taskova-production-ace3.up.railway.app";
+    readonly jobs: "https://gerajobs-production.up.railway.app";
+    readonly eats: "https://fooddash-production-0c1e.up.railway.app";
+};
+export interface HomeProvider {
+    id: string;
+    name: string;
+    category: string;
+    city: string;
+    area?: string;
+    phone?: string;
+    contact?: string;
+    languages?: string;
+    years_in_business?: string;
+    why_qualified?: string;
+    source_url?: string;
+}
+export interface Job {
+    id: string;
+    title: string;
+    organization: string;
+    location: string;
+    category?: string;
+    job_type?: string;
+    salary?: string;
+    website?: string;
+    notes?: string;
+}
+export interface Restaurant {
+    id: string;
+    name: string;
+    business_type?: string;
+    address?: string;
+    postcode?: string;
+    city?: string;
+    hygiene_rating?: string;
+    rating_date?: string;
+    phone?: string;
+    local_authority?: string;
+    lat?: string;
+    lng?: string;
+}
+export declare function searchHomeServices(args: {
+    category?: string;
+    city?: string;
+    limit: number;
+}): Promise<{
+    data_source: DataSource;
+    providers: HomeProvider[];
+    public_url: string;
+    note: string;
+}>;
+export declare function searchJobs(args: {
+    query?: string;
+    location?: string;
+    limit: number;
+}): Promise<{
+    data_source: DataSource;
+    jobs: Job[];
+    public_url: string;
+    note: string;
+}>;
+export declare function searchRestaurants(args: {
+    city?: string;
+    name?: string;
+    min_rating?: number;
+    limit: number;
+}): Promise<{
+    data_source: DataSource;
+    restaurants: Restaurant[];
+    public_url: string;
+    note: string;
+}>;