Skip to content

entroute/place-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

place-search

Find nearby places — coffee shops, restaurants, anything — via verified x402 endpoints. No Google Places billing account.

A tiny example that finds places near a coordinate. EntRoute picks the best-ranked geo endpoint; x402 handles payment.

Why this exists: Google Places needs a project, billing enabled, an API key with restricted scopes, and a quota you'll forget to monitor. Or call a single endpoint and pay $0.001 per query.


Quickstart — Claude Code (recommended, zero config)

claude mcp add entroute -- npx @entroute/mcp-server

Then ask Claude: "Find sushi restaurants near Shibuya station" — it discovers a verified geo endpoint, pays in USDC on Base, and returns matches. No API keys, no wallet setup, no env vars.

About the MCP server →


Use it from your own code

npm install @entroute/sdk-agent-ts

Inspect the top-ranked endpoint:

import { EntRouteClient } from '@entroute/sdk-agent-ts';

const client = new EntRouteClient({ baseUrl: 'https://api.entroute.com' });
const result = await client.discover({ capability_id: 'geo.places_nearby' });
console.log(result.ranked_endpoints[0]);

To actually call it (and have the SDK handle the x402 402 → pay → retry dance), pass a Base wallet via client.discoverAndCall(). See the SDK docs.


Try the demo

Discovery only — prints the top 3 endpoints with score, latency, success rate, and price. No payment, no wallet needed.

git clone https://github.com/entroute/place-search && cd place-search
pnpm install
pnpm start

Source: src/index.ts.


Why EntRoute

The only x402 directory that pays real USDC to verify each endpoint actually works. Probes run every 10 minutes; failed endpoints get demoted automatically.

x402 is the open pay-per-request protocol behind it (Coinbase + Linux Foundation). Server returns 402, client pays in USDC on Base, retries with payment header.


Related skills

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors