Developers and agents

Drive Localnord from your code or your agent

Three integration surfaces: an MCP server for AI agents, a REST API v1 for your own tooling, webhooks for your automations. Everything is scoped to your organization.

Create an API keyMarkdown reference

MCP

Streamable HTTP

REST v1

JSON, API key

12

webhook events

MCP

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.

MCP serverhttps://app.localnord.io/api/mcp/mcp
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 v1

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

Response envelope

{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 50, "total": 134, "total_pages": 3 }
}

Status codes

CodeMeaning
400Invalid body or parameter
401Missing or unknown API key
402Not enough credits (audits, campaigns)
403Revoked key, or listing paused
404Not found, or outside your organization
409State conflict (already published, already answered)
429Rate limit or quota exceeded
500Server error
502Google rejected or is unavailable
Webhooks

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.

review.createdA customer leaves a Google review on a listing
review.negativeA review of 3 stars or less arrives — the signal to route to an alert
publication.publishedA scheduled Google Post goes live
publication.failedA Google Post could not be published, with the reason for the refusal
photo.publishedA scheduled photo has landed on the Google listing
ranking.completedA geolocated ranking scan has completed
ranking.droppedThe average rank dropped by at least 1.5 positions since the previous scan
audit.completedA listing audit is ready, without polling the API
listing.google_changedGoogle changed a listing field without going through you
listing.disconnectedA Google access was revoked or expired: the listings no longer sync
game.playedA player tries their luck on one of your games
lead_magnet.leadA prospect submits a lead magnet and their scan is ready
Agents

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.

curl -H "Accept: text/markdown" https://www.localnord.io/en/pricing
Developers and agents

Ready to integrate Localnord?

Create your account, generate an API key in the dashboard and connect your agent to the MCP server. 7-day trial, no credit card.

Create my accountTalk to the team