Developers and AI connectors

Connect your AI to the Energy North Journal

A free, read-only connector that lets AI assistants search and read our plain-English guides on electrical safety, EICRs, landlord duties and EV chargers in London. No account, no key, no payment.

OpenMCP, Streamable HTTPUpdated 18-10-2026

Connect your AI

Connector address

https://energynorth.uk/api/mcp

In your AI assistant, open the settings for connectors or MCP servers and choose to add a custom connector.

Name it Energy North Journal and paste the address above. Leave sign-in empty: none is needed.

Ask a question such as "Does my rented flat in Haringey need an EICR?". The assistant searches the guides and gives you the link.

Tools

`search_guides`	Search the guides by plain words. Optional journal: all, main or ev.
`get_guide`	Read one guide in full, by its link.
`latest_guides`	The newest guides, newest first.
`booking_info`	Booking links for an EICR (from £100), an EV charger survey or other electrical work.

All tools are read-only. Guides are general information, not legal advice.

API hub

Public endpoints

Method	Path	What it does
POST	`/api/mcp`	MCP server, Streamable HTTP, JSON-RPC 2.0. Open.
GET	`/api/journal?q=eicr&journal=all&limit=8`	Search the guides. No q gives the newest. Open.
GET	`/api/journal/guide?url=…`	Read one guide as plain text. Open.
GET	`/find/<trade>/<city>`	Public trade directory pages. Open, read-only.

Limit: 60 requests a minute per IP on each endpoint. Over the limit the answer is 429 with Retry-After. Full description in openapi.json.

curl -s https://energynorth.uk/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_guides","arguments":{"query":"EICR for landlords"}}}'

Discovery files

Plain summary for AI readers

/llms.txt

MCP server card

/.well-known/mcp/server-card.json

Agent card (A2A)

/.well-known/agent-card.json

API catalogue (RFC 9727)

/.well-known/api-catalog

OpenAPI 3.1

/openapi.json

Access rules: no account, no key, no payment

/auth.md

Skills index

/.well-known/agent-skills/index.json

Crawling and content signals

/robots.txt

The journals

Energy North journal

Electrical safety, EICRs, landlords and business premises in North, East and West London.

EV Charger Installer journal

Home and business EV charger installation in London.

Access

What agents can and cannot do

Agents can search and read the guides and pass on booking links. Booking, paying, posting a job or contacting a tradesperson is always done by a person on the website. The full rules are in auth.md.

Need an electrician now? Book an EICR, from £100 or post a job.