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

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