# Mirelia Structured Data Marketplace
> USPTO patent MCP server for competitive intelligence, prior art search, and IP analytics. 30000+ AI-enriched JSON patents (CPC G/H). Search free via xpay; purchase full datasets with on-chain USDC/ROSE (x402 / MPP v1.0).

## MCP Server URL
https://mirelia-structured-data-marketplace.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY

## Tools
- search_single_patents: 
[COST: 0.02 USDC (API Fee)]
Searches for high-value individual patents ($0.50 each) from a continuously expanding, daily-updated USPTO database.
Returns lightweight evaluation data: [patent_id, title, importance_p, publication_date, primary_cpc, secondary_cpcs, biz_target_ind].

[AVAILABLE PRIMARY CPCs]: 
G01(Measurement/Testing), G02(Optics), G03(Photography), G04(Horology), G05(Control Systems), 
G06(Computing/Data Processing), G07(Checking Devices), G08(Signaling), G09(Displays/Cryptography), 
G10(Acoustics/Speech), G11(Info Storage), G12(Instrument Details), G16(Specific ICT/Healthcare), 
G21(Nuclear), H01(Basic Electric Elements), H02(Electric Power), H03(Electronic Circuitry), 
H04(Communication), H05(Misc Electric), H10(Solid State Devices)

[EXAMPLE ARGUMENTS - MINIMAL]:
{"primary_cpc": "G06"}

[EXAMPLE ARGUMENTS - MAXIMAL]:
{"primary_cpc": "H02", "cross_domain_cpc": "G06", "keyword": "thermal power generation", "min_score": 80, "limit": 50}
 ($0.00/call)
- purchase_single_patent: 
[COST: 0.02 USDC (API Fee) + 0.50 USDC (Data Price)]
Verifies on-chain payment and delivers the FULL structured JSON dataset for a single patent.

[AGENTIC WORKFLOW (MPP v1.0 402 Payment Flow)]:
This is a mandatory 2-step process. Do NOT hallucinate a tx_hash.
STEP 1: Call this tool with ONLY 'patent_id' and 'network'. Leave 'tx_hash' EMPTY. The server will return a 402 Payment Required response containing a 'transaction_payload'.
STEP 2: You MUST securely execute/broadcast the exact 'transaction_payload' on the blockchain using your wallet. This payload contains the required cryptographic HMAC memo to bind your payment to the product.
STEP 3: Once the transaction is confirmed on-chain, call this exact tool AGAIN, providing the 'patent_id', 'network', and the resulting 66-character 'tx_hash'.

[SUPPORTED NETWORKS]: 'polygon' (USDC), 'base' (USDC), 'oasis' (ROSE natively via EOA, or WROSE via AA wallets). Default is 'polygon'.

[EXAMPLE ARGUMENTS - MINIMAL (Step 1 - Request Payment Info)]:
{"patent_id": "US12449246B2"}

[EXAMPLE ARGUMENTS - MAXIMAL (Step 3 - Claim Data)]:
{"patent_id": "US12449246B2", "network": "polygon", "tx_hash": "0x123abc456def7890123abc456def7890123abc456def7890123abc456def7890"}
 ($0.00/call)
- search_packages: 
[COST: 0.02 USDC (API Fee)]
Exploration tool for USPTO bulk patent datasets (10, 100, 1000 items per pack). 
Best for large-scale R&D or commercial analysis.
If 'search_query' is empty, returns the full catalog of available packages.
If 'search_query' contains a CPC or keyword, returns specific domain packs.

[AVAILABLE DOMAINS]: 
G01(Measurement), G02(Optics), G03(Photography), G04(Horology), G05(Control), 
G06(Computing), G07(Checking), G08(Signaling), G09(Displays), G10(Acoustics), 
G11(Storage), G12(Instruments), G16(Healthcare ICT), G21(Nuclear), H01(Electric Elements), 
H02(Power), H03(Circuitry), H04(Communication), H05(Misc), H10(Solid State)

[EXAMPLE ARGUMENTS - MINIMAL (List All Catalogs)]:
{}

[EXAMPLE ARGUMENTS - MAXIMAL (Search Specific Domain & Limit)]:
{"search_query": "G06_100", "limit": 10}
 ($0.00/call)
- verify_crypto_payment_and_deliver: 
[COST: 0.02 USDC (API Fee) + Bulk Package Price]
Verifies on-chain payment and delivers the FULL JSON dataset URL for bulk packages.

[AGENTIC WORKFLOW (MPP v1.0 402 Payment Flow)]:
This is a mandatory 2-step process. Do NOT hallucinate a tx_hash.
STEP 1: Call this tool with ONLY 'package_tag' and 'network'. Leave 'tx_hash' EMPTY. You will receive a 402 response with a 'transaction_payload'.
STEP 2: Execute/broadcast the 'transaction_payload' exactly as provided to apply the HMAC cryptographic memo. Do not modify the payload data.
STEP 3: After confirmation, call this tool AGAIN with the exact 'package_tag', 'network', and the resulting 'tx_hash' to receive the dataset.

[EXAMPLE ARGUMENTS - MINIMAL (Step 1 - Request Payment Info)]:
{"package_tag": "G01_10_001"}

[EXAMPLE ARGUMENTS - MAXIMAL (Step 3 - Claim Data)]:
{"package_tag": "G01_10_001", "network": "base", "tx_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"}
 ($0.00/call)

## Get Started
1. Get an API key at https://xpay.tools
2. Add the MCP server URL to your MCP client config (Claude, Cursor, Windsurf, etc.)
3. Pay per tool call from your XPay wallet — no subscriptions

## Connection Config
```json
{
  "mcpServers": {
    "mirelia-structured-data-marketplace": {
      "url": "https://mirelia-structured-data-marketplace.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}
```

## Pricing
- search_single_patents: $0.00/call
- purchase_single_patent: $0.00/call
- search_packages: $0.00/call
- verify_crypto_payment_and_deliver: $0.00/call

Note: Searching and listing content is free. Reading full articles in markdown is charged. All tools require a valid API key.

## About
Powered by XPay — pay-per-use API access for AI agents.
https://xpay.tools