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.

  • MCPStreamable HTTP
  • REST v1JSON, API key
  • 5webhook events

Localnord developer documentation for EN agencies.

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 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
Pagination
?page=1&per_page=50 (max 100)

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

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.

EventFired when
review.createdA new review is detected
publication.publishedA Google Post is published
ranking.completedA rank scan finishes
game.playedA review-collection game is played
lead_magnet.leadA lead magnet captures a lead

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

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.