MotorAPI MCP Server

MCP (Model Context Protocol) integration for MotorAPI.dk - Danish vehicle registration lookup service.

Features

This MCP server provides tools to lookup Danish vehicle information by registration number or VIN:

• get_vehicle: Get detailed vehicle information (make, model, year, specifications, etc.)

• get_vehicle_environment: Get environmental data (emissions, fuel consumption, environmental class)

• get_vehicle_equipment: Get equipment and features list

• get_api_usage: Check API usage statistics and quota

Related MCP server: Histórico Veicular Nacional

Installation

Prerequisites

• Python 3.10 or higher

• pip

Setup

1. Clone the repository:

git clone https://github.com/ShredderAlex/motorapi-mcp.git
cd motorapi-mcp

2. Install dependencies:

pip install -r requirements.txt

3. (Optional) Set your API key as an environment variable:

export MOTORAPI_KEY="your-api-key-here"

Note: A default API key is included for testing, but you should obtain your own from MotorAPI.dk

Usage

Running the Server

Run the MCP server:

python server.py

Using with Claude Desktop

Add this configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "motorapi": {
      "command": "python",
      "args": ["/path/to/motorapi-mcp/server.py"],
      "env": {
        "MOTORAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop after updating the configuration.

Example Queries

Once connected, you can ask Claude:

• "Look up vehicle information for registration AB12345"

• "Get environmental data for VIN WBA12345678901234"

• "Show me the equipment list for registration XY98765"

• "Check my MotorAPI usage statistics"

API Endpoints

The server integrates these MotorAPI.dk endpoints:

• GET /vehicles/{reg-no-or-vin} - Vehicle details

• GET /vehicles/{reg-no-or-vin}/environment - Environmental data

• GET /vehicles/{reg-no-or-vin}/equipment - Equipment list

• GET /usage - API usage statistics

Cloud Deployment

Deploy to Render

Manual Render Deployment

1. Fork this repository to your GitHub account

2. Sign up/login to Render

3. Create a new Web Service

4. Connect your GitHub repository

5. Configure the service:

   • Name: motorapi-mcp (or your preferred name)

   • Runtime: Python 3

   • Build Command: pip install -r requirements.txt

   • Start Command: python server.py

6. Add environment variable:

   • Key: MOTORAPI_KEY

   • Value: Your MotorAPI.dk API key

7. Click Create Web Service

Using render.yaml (Infrastructure as Code)

The repository includes a render.yaml file for automated deployment:

1. Go to Render Dashboard

2. Click New → Blueprint

3. Connect your GitHub repository

4. Render will automatically detect render.yaml

5. Set the MOTORAPI_KEY environment variable

6. Click Apply

Note: The server uses only pure Python dependencies (no Rust compilation required), ensuring fast and reliable builds on Render's free tier.

Deploy to Railway

1. Click the button above or create a new project on Railway

2. Connect your GitHub repository

3. Set the MOTORAPI_KEY environment variable

4. Deploy!

Development

Project Structure

motorapi-mcp/
├── server.py           # Main MCP server implementation
├── requirements.txt    # Python dependencies
├── README.md          # This file
├── pyproject.toml     # Python project configuration
├── railway.json       # Railway deployment configuration
├── render.yaml        # Render deployment configuration
└── .gitignore         # Git ignore rules

Testing

Test the server using the MCP inspector:

pip install mcp-inspector
mcp-inspector python server.py

Error Handling

The server includes proper error handling for:

• 404 Not Found (vehicle doesn't exist)

• Network errors

• API authentication errors

• Timeout errors

Errors are returned as JSON objects with an error field.

Dependencies

This project uses only pure Python packages with no Rust compilation required:

• mcp (>=1.0.0) - Model Context Protocol SDK

• httpx (>=0.27.0) - Modern async HTTP client

This ensures fast builds and compatibility with all cloud platforms.

License

MIT License - feel free to use and modify as needed.

Resources

• MotorAPI.dk Documentation

• Model Context Protocol

• MCP Python SDK

Support

For issues or questions:

• Open an issue on GitHub

• Check MotorAPI.dk documentation for API-related questions