npm install -g opensincera-mcp-server

git clone https://github.com/miyaichi/opensincera-mcp-server.git
cd opensincera-mcp-server

npm install

npm run build

export OPENSINCERA_API_KEY="your-api-key-here"
export OPENSINCERA_BASE_URL="https://open.sincera.io/api"  # Optional
export OPENSINCERA_TIMEOUT="10000"  # Optional (milliseconds)

npm start

npm run dev

{
  "mcpServers": {
    "opensincera": {
      "command": "opensincera-mcp-server",
      "env": {
        "OPENSINCERA_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "opensincera": {
      "command": "node",
      "args": ["/path/to/opensincera-mcp-server/dist/index.js"],
      "env": {
        "OPENSINCERA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Check the OpenSincera API connection status

Get publisher information for yahoo.com from OpenSincera

Analyze the publisher metrics for cnn.com and explain:
- Their verification status
- Ad to content ratio and what it means
- Supply chain complexity
- Overall advertising quality

Show me the mobile vs desktop ad quality metrics for nytimes.com

Compare businessinsider.com against its similar publishers

Evaluate these publishers for a mobile branding campaign:
- nytimes.com
- washingtonpost.com
- reuters.com
Use device: mobile

Get detailed information for OpenSincera Publisher ID 2737

I'm considering running ad campaigns on forbes.com.
Can you check their OpenSincera profile and tell me:
- Is this a verified publisher?
- What's their ad refresh rate and is it good or bad?
- How many supply paths do they have?
- Would you recommend this publisher for quality ad placement?

{
  "publisherDomain": "example.com"
}

{
  "domain": "example.com"
}

{
  "publisherId": "12345"
}

{
  "domain": "businessinsider.com",
  "device": "mobile"
}

{
  "domains": ["nytimes.com", "washingtonpost.com", "reuters.com"],
  "campaignGoal": "branding",
  "device": "desktop"
}

{
  "publishers": [
    {
      "publisherId": "1",
      "publisherName": "Business Insider",
      "ownerDomain": "insider-inc.com",
      "domain": "businessinsider.com",
      "status": "active",
      "lastUpdated": "2026-04-14T01:00:25.419Z",
      "categories": [],
      "verificationStatus": "verified",
      "parentEntityId": 59072,
      "similarPublishers": [41, 67, 405],
      "deviceMetrics": {
        "mobile": {
          "avgAdsToContentRatio": 0.265,
          "maxAdsToContentRatio": 1.0,
          "minAdsToContentRatio": 0.0,
          "avgAdUnitsInView": 1.611,
          "maxAdUnitsInView": 4.0,
          "averageRefreshRate": 58.441,
          "maxRefreshRate": 420.0,
          "minRefreshRate": 5.0,
          "percentageOfAdSlotsWithRefresh": 98.78
        },
        "desktop": {
          "avgAdsToContentRatio": 0.231,
          "maxAdsToContentRatio": 1.0,
          "minAdsToContentRatio": 0.0,
          "avgAdUnitsInView": 2.577,
          "maxAdUnitsInView": 9.0,
          "averageRefreshRate": 81.096,
          "maxRefreshRate": 590.0,
          "minRefreshRate": 5.0,
          "percentageOfAdSlotsWithRefresh": 84.99
        }
      },
      "metadata": {
        "description": "Business Insider tells the global tech, finance...",
        "primarySupplyType": "web",
        "avgAdsToContentRatio": 0.249,
        "avgAdsInView": 2.088,
        "avgAdRefresh": 72.489,
        "totalUniqueGpids": 946,
        "idAbsorptionRate": 0.5,
        "avgPageWeight": 27.843,
        "avgCpu": 254.671,
        "totalSupplyPaths": 118,
        "resellerCount": 69,
        "slug": "business-insider"
      }
    }
  ],
  "totalCount": 1,
  "hasMore": false
}

{
  "healthy": true,
  "timestamp": "2026-04-14T10:00:00Z"
}

src/
├── index.ts                 # Main MCP server entry point and tool definitions
├── opensincera-service.ts   # OpenSincera API client and data models
├── metadata-descriptions.ts # Field descriptions and formatted output
└── analysis.ts              # Scoring, comparison, and evaluation logic