Drive Localnord from your code or your agent.Drive Localnord fromyour code or your agent.

# Localnord · developers
 
## Localnord MCP server
 
Connect Claude, Claude Code or any MCP client to the Localnord server: your agent lists the listing portfolio, audits it, writes posts, answers reviews and produces white-label reports.
 
- Endpoint: https://app.localnord.io/api/mcp/mcp
- Transport: Streamable HTTP
- Authentication: OAuth 2.1
- Manifest: https://www.localnord.io/.well-known/mcp.json
 
### Tool families
 
- `listings`: List, audit, sync and update Google Business Profile listings.
- `reviews`: Read reviews, generate and publish replies, run review campaigns.
- `publications`: Draft, schedule and publish Google Posts, photos and videos.
- `rankings`: Local rank tracking, keyword analysis and competitor benchmarks.
- `prospecting`: Search and enrich prospects, white-label audits, marketplace leads.
- `reporting`: White-label PDF reports, client portal access, agency statistics.
- `account`: Credits, quotas, invoices, team members and organization branding.
 
## REST API v1
 
An API key is bound to a single organization: every request is filtered automatically, a key can never read another agency's data. The key is shown once and stored hashed.
 
- Base URL: https://app.localnord.io/api/v1
- Authentication: Authorization: Bearer lnk_…
- Rate limit: 10 000 req/day/key · reset 00:00 UTC
- Pagination: ?page=1&per_page=50 (max 100)
- Quota headers: X-RateLimit-Limit / -Remaining / -Reset
- Full reference: https://app.localnord.io/api/v1/docs.md
 
### Status codes
 
- `400`: Invalid body or parameter
- `401`: Missing or unknown API key
- `402`: Not enough credits (audits, campaigns)
- `403`: Revoked key, or listing paused
- `404`: Not found, or outside your organization
- `409`: State conflict (already published, already answered)
- `429`: Rate limit or quota exceeded
- `500`: Server error
- `502`: Google rejected or is unavailable
 
### Response envelope
 
```
{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 50, "total": 134, "total_pages": 3 }
}
```
 
## Webhooks
 
Subscribe an HTTPS endpoint to Localnord events (up to 20 webhooks per organization). With a signing secret configured, every delivery carries an X-Webhook-Signature HMAC-SHA256 header.
 
### Events
 
- `review.created`: A customer leaves a Google review on a listing
- `review.negative`: A review of 3 stars or less arrives: the signal to route to an alert
- `publication.published`: A scheduled Google Post goes live
- `publication.failed`: A Google Post could not be published, with the reason for the refusal
- `photo.published`: A scheduled photo has landed on the Google listing
- `ranking.completed`: A geolocated ranking scan has completed
- `ranking.dropped`: The average rank dropped by at least 1.5 positions since the previous scan
- `audit.completed`: A listing audit is ready, without polling the API
- `listing.google_changed`: Google changed a listing field without going through you
- `listing.disconnected`: A Google access was revoked or expired: the listings no longer sync
- `game.played`: A player tries their luck on one of your games
- `lead_magnet.lead`: A prospect submits a lead magnet and their scan is ready
 
## For AI agents
 
Every page of localnord.io has a Markdown representation: send the Accept: text/markdown header and the same URL answers with text/markdown and Vary: Accept. Unsupported media types return 406.
 
### Resources
 
- `https://app.localnord.io/api/v1/docs.md`: Full API reference, public and key-free
- `/llms.txt`: AI index of the site
- `/kb/developers.md`: This reference in Markdown
- `/.well-known/mcp.json`: MCP server manifest
- `/sitemap.xml`: Full sitemap
 
### Example
 
```
curl -H "Accept: text/markdown" https://www.localnord.io/en/pricing
```