About ByeFine parking guides
ByeFine parking-guides is a free, read-only MCP server for people handling UK parking tickets and penalty notices. It provides sourced guides, council code explanations and deadline calculations without an API key.
Key features
- 01Search and retrieve parking guides
- 02Explain council PCN codes
- 03Search codes in plain language
- 04Calculate legal response deadlines
Use cases
- 01Understand a UK parking notice
- 02Find the meaning of a council code
- 03Check deadlines from notice dates
MCP support
Exposes free, read-only guide, code-lookup and deadline tools through a remote MCP server at https://byefine.com/api/public/mcp. No API key is required.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://byefine.com/api/public/mcpclaude mcp add --transport http com-byefine-parking-guides https://byefine.com/api/public/mcp{"mcpServers":{"com-byefine-parking-guides":{"type":"http","url":"https://byefine.com/api/public/mcp"}}}Open in Cursor{"servers":{"com-byefine-parking-guides":{"type":"http","url":"https://byefine.com/api/public/mcp"}}}Open in VS Code{"mcpServers":{"com-byefine-parking-guides":{"type":"http","url":"https://byefine.com/api/public/mcp"}}}{"mcpServers":{"com-byefine-parking-guides":{"serverUrl":"https://byefine.com/api/public/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEByeFine MCP servers
ByeFine checks UK parking tickets and penalty notices for free, then writes and sends the appeal. It runs two remote MCP servers (Streamable HTTP, protocol 2025-06-18). This repository holds their registry entries and the source of the protocol handler and of the free tools.
| Server | Address | Key |
|---|---|---|
com.byefine/byefine | https://byefine.com/api/mcp | Optional. The free tools work without one. Checking a notice and your own cases need your ByeFine API key (Authorization: Bearer ..., made on your account page) or signing in from your app. |
com.byefine/parking-guides | https://byefine.com/api/public/mcp | None. Free tools only. |
Add it
claude mcp add --transport http byefine https://byefine.com/api/mcp
claude mcp add --transport http parking-guides https://byefine.com/api/public/mcp
Any other MCP client: add a remote (HTTP) server with the address above.
Tools
Free, read only, on both servers:
| Tool | What it does |
|---|---|
search_guides, get_guide, list_guides | ByeFine's plain-English guides to UK parking tickets and appeals, as published on byefine.com/guides, with their sources. |
explain_contravention_code | A council PCN contravention code: what it means, higher or lower level, suffix letters, and the grounds the law allows for formal representations in England. |
search_contravention_codes | Finds a code from plain words ("disabled bay", "yellow box junction"). |
calculate_deadlines | The time limits the law sets in England for a council PCN or a private parking charge, from the dates printed on it, each with its legal source. Every date errs early. |
With a key or sign-in, on com.byefine/byefine only:
| Tool | What it does |
|---|---|
check_notice | Reads a photo or PDF of a notice and says, free, whether it is worth challenging. |
list_cases, get_case | Your cases and where each appeal stands. |
go_ahead | Starts the appeal. The driver gives permission on the case page before anything is filed. |
What is in here
src/mcp-core.ts: the stateless JSON-RPC handler both servers use.src/pcn-codes.ts: council contravention codes from the standard list London Councils publishes. Charge level only: amounts depend on the council and are printed on the notice.src/pcn-deadlines.ts,src/day-count.ts: the deadline calculator. Sources: SI 2022/71 reg 20, SI 2022/576 regs 5 and 6, the DfT statutory guidance on enforcing parking restrictions, the Protection of Freedoms Act 2012 Schedule 4 paras 8 and 9, the Private Parking Sector Single Code of Practice, and POPLA's and the IAS's own pages.registry/: the entries published to the official MCP registry.
The guide text and the account tools run inside the ByeFine web app, which is not open source. These files are copied from it, so they match what the servers run.
npm install && npm test
General information for England, not legal advice. Always go by the dates and amounts printed on the notice.
Questions: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.