O-Score MCP Server

Give your AI assistant live access to EU dropshipping data. This Model Context Protocol server lets Claude, Cursor and any other MCP-capable agent score products, validate VAT numbers and check EU price-compliance rules during a conversation.

No API key needed to start. The server talks directly to the public API on the free tier. Add a RapidAPI key only when you need higher limits.

Download the server
One Python file, MIT licensed, no build step.
oscore-mcp-server.py →

Available tools

Tool	What it does
`score_product`	Scores one product 0-100 on margin, EU delivery time and risk
`bulk_score`	Scores up to 25 products at once and ranks them
`trending_niches`	Trending EU niches with average scores
`validate_vat`	Validates an EU VAT number against the official VIES service
`vat_rates`	Standard and reduced VAT rates for all 27 member states
`omnibus_check`	Checks the EU Omnibus lowest-price-in-30-days rule
`shipping_threshold`	Margin-safe free-shipping threshold

Install

pip install mcp requests

Then add this to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "oscore": {
      "command": "python",
      "args": ["/path/to/oscore-mcp-server.py"]
    }
  }
}

Restart Claude Desktop. Ask it something like "Score a 12 euro cat water fountain shipped from an EU warehouse in 5 days" and it will call the API for you.

Using a paid plan

For higher rate limits, add your RapidAPI key as an environment variable:

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

Direct API access

Prefer plain HTTP? The same endpoints are public:

curl -X POST https://api.insightoperator.org/api/v1/score \
  -H 'Content-Type: application/json' \
  -d '{"name":"Cat water fountain","cost_price":12.50,
       "eu_delivery_days":5,"eu_warehouse":true}'

There are Python and JavaScript SDKs too: pip install oscore · npm install oscore-check

Data accuracy

VAT rates were verified on 20 July 2026 against multiple independent sources plus national tax authorities, and are re-checked every January. VAT number validation calls the European Commission's VIES service live, so results are as current as VIES itself. Scores are indicative and are not financial or tax advice.