OpenSincera

Provides access to OpenSincera publisher metadata, verification data, and health status via MCP endpoints.

typescript

1

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "miyaichi-opensincera-mcp-server": {
      "command": "opensincera-mcp-server",
      "args": [],
      "env": {
        "OPENSINCERA_API_KEY": "your-api-key-here",
        "OPENSINCERA_TIMEOUT": "10000",
        "OPENSINCERA_BASE_URL": "https://open.sincera.io/api"
      }
    }
  }
}

OpenSincera MCP Server lets you query publisher metadata, verification status, and operational metrics from OpenSincera through a focused MCP interface. It’s useful for AI assistants and tools that need up-to-date publisher information and health status to make informed ad placement decisions.

How to use

You interact with the OpenSincera MCP Server by connecting an MCP client to its endpoints or by running the server locally and pointing your client to the local process. Use the available MCP tools to fetch publisher metadata, look up publishers by domain or Publisher ID, and perform health checks to verify the API connection is healthy. You can also attach an API key for authenticated access and rely on input validation to ensure requests are well-formed.

Typical workflows include looking up a publisher by domain to retrieve verification status, categories, and metadata; running a health check to confirm the OpenSincera API is reachable before launching campaigns; and querying by Publisher ID to retrieve precise profile details. For deployment in Claude Desktop or similar environments, configure the MCP server as either a global system command or a local node-based script, then reference the server by its configured name in your prompts.

How to install

# Prerequisites
# - Node.js 18.0.0 or higher
# - OpenSincera API key

# Install the MCP server globally
npm install -g opensincera-mcp-server

# Optional: clone the project locally (if you prefer local development)
git clone https://github.com/miyaichi/opensincera-mcp-server.git
cd opensincera-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

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

# Start the server
npm start

Additional content

Configuration with Claude Desktop is supported. You can run the MCP server either as a globally installed command or from a local clone, and you supply the API key via environment variables in the integration configuration.

Health and error handling are designed to give clear feedback when authentication fails, the API is unreachable, or a requested publisher cannot be found. Input validation helps you catch malformed queries before they reach the API.

Available tools

get_publisher_metadata

Fetch publisher metadata, including verification status, categories, and metadata fields. Accepts optional publisherId or publisherDomain to search and supports pagination parameters.

get_publisher_by_domain

Retrieve a single publisher by its domain name. Requires the domain to be provided.

get_publisher_by_id

Retrieve a single publisher by its Publisher ID. Requires the publisherId to be provided.

health_check

Check the health status of the OpenSincera API connection to ensure the service is reachable.