Model Context Protocol (MCP)

Connect your AI agent in seconds

MediaShare exposes thin MCP servers on top of our canonical HTTP APIs. Each server translates tool invocations and validates schemas without locking you into any specific AI platform or vendor.

Agent Client Configurations

claude_desktop_config.json

{
  "mcpServers": {
    "mediashare-wine": {
      "command": "npx",
      "args": ["-y", "@mediashare/mcp-wine"],
      "env": {
        "MEDIASHARE_WINE_API_KEY": "YOUR_API_KEY"
      }
    },
    "mediashare-geo": {
      "command": "npx",
      "args": ["-y", "@mediashare/mcp-geo"]
    },
    "mediashare-finance": {
      "command": "npx",
      "args": ["-y", "@mediashare/mcp-finance"]
    }
  }
}

Available MCP Servers & Tools

Wine Search MCP

@mediashare/mcp-wine

wine.mediashare.ro

Search and resolve wine metadata, ratings, wineries, and vintage pricing.

Quick Run Command

npx -y @mediashare/mcp-wine

Required Environment Variables

MEDIASHARE_WINE_API_KEY * — Bearer API key for wine search service

Supported Tools (1)

wine_search() Search the wine database by natural-language query and optional vintage.

Parameter	Type	Required	Description
`q`	string	yes	Wine title, winery, or natural query (e.g. 'Purcari Malbec 2020')
`vintage`	number	optional	Specific harvest year

Returns: Wine object with winery, year, rating score, reviews, and average price

IP Geolocation MCP

@mediashare/mcp-geo

geo.mediashare.ro

Free IP address resolution returning country, city, coordinates, timezone, and network metadata.

Quick Run Command

npx -y @mediashare/mcp-geo

Supported Tools (1)

geo_lookup() Resolve caller IP or targeted IP address to geographic location, coordinates, timezone, and network ASN details.

Parameter	Type	Required	Description
`addr`	string	optional	IP address or location to lookup. If omitted, resolves caller's client IP.

Returns: Location record with IP, country ISO code, region, city, coordinates, timezone, and ASN network details

Romanian Market Data MCP

@mediashare/mcp-finance

ro-finance.mediashare.ro

BNR official currency exchange rates, mutual fund NAVs, and bond references.

Quick Run Command

npx -y @mediashare/mcp-finance

Supported Tools (1)

finance_fx_rates() Get National Bank of Romania (BNR) daily exchange rates.

Parameter	Type	Required	Description
`currency`	string	optional	3-letter currency code (e.g. 'EUR', 'USD')
`date`	string	optional	ISO date format (YYYY-MM-DD) for historical lookup

Returns: Observed rates with multiplier, source attribution, and freshness timestamp

URL Metadata MCP

@mediashare/mcp-meta

meta.mediashare.ro

Safely extract OpenGraph tags, title, description, and structured text from URLs.

Quick Run Command

npx -y @mediashare/mcp-meta

Required Environment Variables

MEDIASHARE_META_API_KEY * — Bearer API key for URL extraction

Supported Tools (1)

meta_extract() Fetch a public URL and extract its OpenGraph tags and article content safely.

Parameter	Type	Required	Description
`url`	string	yes	Public web URL to inspect
`include_content`	boolean	optional	Whether to return readable article text

Returns: Structured metadata payload with title, description, author, and OpenGraph tags

RO Utilities MCP

@mediashare/mcp-ro

ro.mediashare.ro

Romanian CNP, CUI, CIF, and IBAN format validation with checksum verification.

Quick Run Command

npx -y @mediashare/mcp-ro

Supported Tools (1)

ro_validate() Validate Romanian fiscal or identity numbers (CNP, CUI, CIF, IBAN).

Parameter	Type	Required	Description
`identifier`	string	yes	Value to validate
`kind`	string	yes	'cnp', 'cui', 'cif', or 'iban'

Returns: Validation result with format validity, checksum status, and extracted metadata