# How to Add NearNow to Meta Muse as a Custom Connector

> Guide page final draft (E3, W0-11; parametrized 2026-09-26 per COO order). **Publish at T day: `https://locafact.com/guides/add-to-muse`.**
>
> **Pending parameters (replace globally, 5 min):**
> | Parameter | Meaning | Current value |
> |---|---|---|
> | `locafact.com` | Main brand domain | pending D-03 + W0-01 |
> | `https://mcp.locafact.com/nearnow/mcp` | Production MCP endpoint | `https://mcp.locafact.com/nearnow/mcp` (final; O19: old EdgeOne URL nearnow.paper.ac.cn is retired, temp workers.dev endpoint comes from W0-17) |
>
> **Pre-publish gate (PM executes):** the endpoint value is final but **not yet publicly resolvable** (O19: EdgeOne route closed; a temporary workers.dev endpoint from W0-17 is used for the A8 test until the domain resolves). Before publishing, PM runs steps 1–4 once with a US-region Muse account (A8 live test); fix wording against the actual UI flow, delete the internal-notes section, then publish. Nothing else needs editing — the copy is final except the two parameters above.

**NearNow** lets your Meta Muse agent find nearby public places — pharmacies, supermarkets, gas stations, EV chargers, libraries, post offices — with **honest, attributed opening-hours data from OpenStreetMap**. If NearNow can't confirm a place is open, it says so instead of guessing.

No account, no API key, no installation. One URL.

---

## What you need

- The Meta Muse app (US, 18+) with connectors enabled
- 2 minutes

## Steps

1. **Open a new Muse conversation.**
2. **Ask Muse to create a custom connector**, and paste the endpoint URL:

   ```
   Add NearNow as a custom connector. It's an MCP server at:
   https://mcp.locafact.com/nearnow/mcp
   ```

   【E3 assumption note: per PRD §1.1 field research, Muse builds custom connectors from an MCP URL given in conversation; if the live UI exposes a "Settings → Connectors → Add custom connector" entry by T day, prefer that entry and paste the same URL.】

3. **Let Muse build and test it.** Muse connects to the endpoint, discovers the tools, and saves NearNow as a reusable skill for your account.
4. **Try it:**

   ```
   Find pharmacies near Pasadena, CA 91101.
   Which supermarkets are near downtown Los Angeles? Show their opening hours.
   Find EV charging stations near San Gabriel, CA.
   I need a gas station near Alhambra, CA that is open now.
   ```

## What the tools do

| Tool | What it answers |
|---|---|
| `search_places` | Find places by area + category (pharmacy / supermarket / fuel / ev_charging / library / post_office), with optional "open now" filter |
| `get_place_details` | Full details for one place: exact coordinates, address, opening hours with confidence level, contact info, OpenStreetMap link |
| `list_categories` | List supported categories if you're unsure what to ask for |

## Honest hours, with sources

Every opening-hours answer carries a confidence level (`confirmed` / `estimated` / `unknown`) and the data source. When NearNow cannot confirm, it says so — it will not guess.

## Troubleshooting

- **First query is slow (up to ~20 s):** uncached queries hit OpenStreetMap live; repeat queries in the same area answer in under a second.
- **"Unsupported category":** ask `list supported place categories` and retry with a listed category.
- **Unknown area:** use a US city or ZIP code; coverage follows OpenStreetMap US data.
- **Connection fails:** the endpoint may be briefly down — retry in a minute. Support: the support email on this site's contact page.

## Data & privacy

- Place data © [OpenStreetMap](https://www.openstreetmap.org/copyright) contributors (ODbL), attributed in every response.
- The service does not collect end-user personal information; only a hashed client fingerprint is recorded for rate limiting and statistics.
- Read-only: NearNow never writes anywhere.

---

## E3 internal notes (delete before publishing)

1. 【A8 live test】At T day run steps 1–4 with a US Muse account; fix wording against actual UI flow; only then publish. Acceptance for W0-11 is "a third party with the real MCP URL can follow it successfully".
2. Auth decision pending COO: if the production endpoint ends up requiring a free API key, step 2 must add "get a free key at <page>" and step 3 a key-entry line.
3. Same guide pattern reusable for Grok custom connectors (`grok.com/connectors` → New Connector → Custom, paid tier) — do not publish the Grok variant until NearNow is stable in Muse (PRD §5 priority P1).
4. When publishing to the site, pair with a short note in r/MuseAgent and a PR to `Anil-matcha/awesome-muse-connectors` (the Muse inventory channel identified in the W0-11 research) — see `D:\meta\brand\guides\README.md` T-day checklist.