---
title: "Model Context Protocol (MCP) — MediaShare"
description: "Connect MediaShare capabilities directly to AI agents in Claude Desktop, Cursor, Pi, and Codex."
---

# Model Context Protocol (MCP)

Connect MediaShare capabilities directly to AI agents in Claude Desktop, Cursor, Pi, and Codex.

## 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

### claudeDesktop

File: `claude_desktop_config.json`

```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"]
    }
  }
}
```

### cursor

File: `.cursor/mcp.json`

```json
{
  "mcpServers": {
    "mediashare": {
      "command": "npx",
      "args": ["-y", "@mediashare/mcp-wine"],
      "env": {
        "MEDIASHARE_WINE_API_KEY": "${env:MEDIASHARE_WINE_API_KEY}"
      }
    }
  }
}
```

### pi

File: `settings.json`

```json
{
  "mcp": {
    "servers": {
      "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"]
      }
    }
  }
}
```

## Available MCP Servers & Tools

### Wine Search MCP

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

Install: `npx -y @mediashare/mcp-wine`

#### wine_search

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

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

### IP Geolocation MCP

IP address geolocation, geocoding, proxy & threat intelligence, distance calculation, and Geonames hierarchy.

Install: `npx -y @mediashare/mcp-geo`

#### geo_lookup

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

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

#### geo_proxy_check

Analyze IP address for proxy, VPN, Tor, and datacenter threat intelligence (requires API key).

Returns: Threat intelligence record with is_proxy, is_vpn, is_tor, risk_score, and threat_level

#### geo_distance

Calculate great-circle linear (Haversine) distance and compass bearing between two locations.

Returns: Distance breakdown in kilometers, miles, meters, and compass bearing degrees

### Romanian Market Data MCP

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

Install: `npx -y @mediashare/mcp-finance`

#### finance_fx_rates

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

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

### URL Metadata MCP

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

Install: `npx -y @mediashare/mcp-meta`

#### meta_extract

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

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