Update to Lukka Digital Assets Intel

{
  "description": "Route digital asset and blockchain data queries to the correct Lukka MCP tool across 7 hosted servers. Use when user asks about: digital asset prices, OHLCV candles, market cap, VWAP, order book depth, trading pairs, exchange sources, derivatives, implied rates, volatility surface, OTC FX, reference data, asset taxonomy, sector classifications, entity/custodian/VASP lookups, asset mappings, AML reports, wallet balances, on-chain transactions, block data, digital asset news, daily summaries, sentiment analysis, or prediction markets.",
  "included_files": [
    {
      "relative_path": "references/aml.md",
      "size_in_bytes": 3730
    },
    {
      "relative_path": "references/analytics.md",
      "size_in_bytes": 3098
    },
    {
      "relative_path": "references/news.md",
      "size_in_bytes": 6320
    },
    {
      "relative_path": "references/predmar.md",
      "size_in_bytes": 3346
    },
    {
      "relative_path": "references/pricing.md",
      "size_in_bytes": 7557
    },
    {
      "relative_path": "references/refdata.md",
      "size_in_bytes": 6529
    },
    {
      "relative_path": "references/tool-bindings.json",
      "size_in_bytes": 5041
    },
    {
      "relative_path": "references/uda.md",
      "size_in_bytes": 3447
    }
  ],
  "name": "lukka-data-routing",
  "skill_md_contents": "---\nname: lukka-data-routing\ndescription: \"Route digital asset and blockchain data queries to the correct Lukka MCP tool across 7 hosted servers. Use when user asks about: digital asset prices, OHLCV candles, market cap, VWAP, order book depth, trading pairs, exchange sources, derivatives, implied rates, volatility surface, OTC FX, reference data, asset taxonomy, sector classifications, entity/custodian/VASP lookups, asset mappings, AML reports, wallet balances, on-chain transactions, block data, digital asset news, daily summaries, sentiment analysis, or prediction markets.\"\n---\n\n## OpenAI connection notes\n\nTool identifiers below are raw operation names. The host may add a namespace;\nuse the matching advertised Global MCP tool. Resolve `<resolved-package-root>`\nto this plugin's installed directory before using paths. Workflow names identify\npackaged skills; they are not literal Claude slash commands.\n\n# Lukka Data Routing\n\n**STANDALONE**: This skill provides routing knowledge and domain conventions that help answer digital asset data questions from general knowledge. **SUPERCHARGED**: When the 7 Lukka MCP servers are connected, this skill routes queries to the exact right tool with correct parameters, avoiding common API pitfalls.\n\nSeven hosted MCP servers. Pick the right one on the first try.\n\n## Tool Naming Convention\n\nProduction tools are exposed with the prefix `<group>___<tool>` (triple underscore before the tool name). Always call tools with the full wire name - use the matching operation advertised by the host.\n\n| Server | Prefix |\n|--------|--------|\n| Lukka-Pricing | `pricing___*` |\n| Lukka-RefData | `refdata___*` |\n| Lukka-AML | `AML___*` |\n| Lukka-UDA | `UDA___*` |\n| Lukka-Analytics | `analytics___*` |\n| Lukka-News | `news___*` |\n| Lukka-Predmar | `prediction-markets___*` |\n\n## Resolution and matching approach\n\n- **Asset/pair/market resolution**: use direct filters on refdata tools (`list_assets`, `get_asset_mappings`, `get_pair_mappings`).\n- **Derivative instrument matching**: use `get_derivative_source_details` with client-side string match.\n\n## Route the Query\n\n| User asks about | Server | Tool | Ref |\n|---|---|---|---|\n| Current price | Lukka-Pricing | `get_latest_prices` | [pricing](references/pricing.md) |\n| Price history / charts | Lukka-Pricing | `get_historical_prices` or `get_candles` | [pricing](references/pricing.md) |\n| Index / reference rate | Lukka-Pricing | `get_latest_index_prices` (Reference Rate access; standard path: sourceId 1000/2000) | [pricing](references/pricing.md) |\n| Market cap / top N | Lukka-Pricing | `get_latest_market_caps` with `order:\"DESC\"` | [pricing](references/pricing.md) |\n| VWAP | Lukka-Pricing | `get_vwap` | [pricing](references/pricing.md) |\n| Order book / depth | Lukka-Pricing | `get_market_depth` | [pricing](references/pricing.md) |\n| Order book snapshot | Lukka-Pricing | `get_order_book_snapshot` | [pricing](references/pricing.md) |\n| Spot trades | Lukka-Pricing | `get_spot_trades` | [pricing](references/pricing.md) |\n| Exchange sources | Lukka-Pricing | `list_pricing_sources` | [pricing](references/pricing.md) |\n| Derivatives trades | Lukka-Pricing | `get_latest_derivative_trades` | [pricing](references/pricing.md) |\n| Derivative source detail | Lukka-Pricing | `get_derivative_source_details` | [pricing](references/pricing.md) |\n| What is asset X | Lukka-RefData | `get_asset_mappings(lukkaAssetCode)` -> `get_asset_by_id(assetLid)` | [refdata](references/refdata.md) |\n| Find assets by trait | Lukka-RefData | `list_assets` + client-side filter | [refdata](references/refdata.md) |\n| Exchange mappings | Lukka-RefData | `get_asset_mappings` | [refdata](references/refdata.md) |\n| Sectors / taxonomy | Lukka-RefData | `get_sectors` | [refdata](references/refdata.md) |\n| LCAS quality scores | Lukka-RefData | `get_core_asset_scores` | [refdata](references/refdata.md) |\n| Entities / exchanges | Lukka-RefData | `get_entity_by_code` / `list_entities` | [refdata](references/refdata.md) |\n| VASPs | Lukka-RefData | `list_vasps` | [refdata](references/refdata.md) |\n| Crypto Actions | Lukka-RefData | `get_asset_crypto_actions` / `get_crypto_actions` | [refdata](references/refdata.md) |\n| Pair mapping lookup | Lukka-RefData | `get_pair_mappings` | [refdata](references/refdata.md) |\n| AML light check | Lukka-AML | `generateAmlScoringReport` | [aml](references/aml.md) |\n| AML full report | Lukka-AML | `generateAmlStandardReport` (pipe through processor) | [aml](references/aml.md) |\n| AML deepest report | Lukka-AML | `generateAmlEnhancedReport` (pipe through processor) | [aml](references/aml.md) |\n| Wallet balance | Lukka-UDA | `get_address_balance` | [uda](references/uda.md) |\n| Wallet assets | Lukka-UDA | `get_address_assets` | [uda](references/uda.md) |\n| Wallet transactions | Lukka-UDA | `get_address_transactions` | [uda](references/uda.md) |\n| Transaction detail | Lukka-UDA | `Get_transaction_for_txhash` | [uda](references/uda.md) |\n| Newest block | Lukka-UDA | `Get_newest_block_blockheight` | [uda](references/uda.md) |\n| Block detail | Lukka-UDA | `get_block` | [uda](references/uda.md) |\n| Implied forward rates | Lukka-Analytics | `getImpliedRates` | [analytics](references/analytics.md) |\n| OTC FX implied rates | Lukka-Analytics | `getImpliedRatesOtcFx` | [analytics](references/analytics.md) |\n| Volatility surface | Lukka-Analytics | `getImpliedVolatilitySurface` | [analytics](references/analytics.md) |\n| Digital asset news / articles | Lukka-News | `getNews` | [news](references/news.md) |\n| News by sentiment | Lukka-News | `getNews` (with `sentiment` param) | [news](references/news.md) |\n| Daily news summary / digest | Lukka-News | `getDailySummaries` | [news](references/news.md) |\n| Regulatory / security news | Lukka-News | `getNews` (with `primaryCategory` filter) | [news](references/news.md) |\n| Prediction markets | Lukka-Predmar | `GetPredictionMarkets` | [predmar](references/predmar.md) |\n| Prediction market news | Lukka-Predmar | `GetMarketNews` (NOT Lukka-News `getNews`) | [predmar](references/predmar.md) |\n| Market sentiment / overview | Lukka-Predmar | `GetMarketOverview` / `GetMarketRecap` | [predmar](references/predmar.md) |\n| Similar markets | Lukka-Predmar | `GetSimilarMarkets` | [predmar](references/predmar.md) |\n| Prediction classification | Lukka-Predmar | `GetPMCSstats` / `GetPredictionMarketsTaxonomy` | [predmar](references/predmar.md) |\n\n## Decision Tree\n\n```\nPrice / market data?       -> Lukka-Pricing\nWhat is asset X?           -> Lukka-RefData (list_assets with assetCode filter)\nFind assets by trait?      -> Lukka-RefData + client-side filter\nAML / compliance?          -> Lukka-AML (report-only surface)\nOn-chain raw data?         -> Lukka-UDA\nNews / articles / headlines?-> Lukka-News\nPrediction markets?        -> Lukka-Predmar\nDerivatives match?         -> Lukka-Pricing (get_derivative_source_details)\nImplied rates / curves?    -> Lukka-Analytics (getImpliedRates)\nVol surface?               -> Lukka-Analytics (getImpliedVolatilitySurface)\nOTC FX rates?              -> Lukka-Analytics (getImpliedRatesOtcFx)\n```\n\n## Critical Patterns\n\n**Pair format**: `BASE-COUNTER` - e.g. `XBT-USD`, `ETH-USD`, `SOLN-USD`. Not `BTC-USD`.\n\n**Intervals in MILLISECONDS** (not seconds): `1000`, `5000`, `30000`, `60000`, `300000`, `1800000`, `3600000`, `86400000` (1s..1day, default `60000`). Hourly (`3600000`) works directly on `get_historical_prices` - no need for `get_candles`.\n\n**Response modes** (pricing, refdata):\n- Default = summary with stats\n- `detailed: true` = paginated raw data\n- `export: true` = CSV content\n\n**Blockchain symbol case**:\n- Lowercase for Lukka-UDA: `btc`, `eth`, `sol`, `trx`\n- Uppercase for Lukka-AML report tools: `BTC`, `ETH`, `SOL`, `TRX`\n\n**Source IDs** (Lukka-Pricing) - fixed high-level:\n- `1000` = Lukka Prime EOD (also market cap)\n- `2000` = Intraday, `2100` = Prime Global Intraday\n- `3000` = Hourly\n- `5001` / `5002` = Reference Rate / Median Reference Rate - available with Lukka Reference Rate access (request at https://lukka.tech/plugin); standard path: sourceId 1000 (EOD) / 2000 (Intraday)\n- `5004` = Staking Rates, `5005` = MVWAP\n\nClient-assigned (discover via `list_pricing_sources`, do NOT guess): exchanges `4001-4999`, index `6xxx`, custom `10xxx`.\n\n## Common Errors\n\n| Error | Cause | Fix |\n|---|---|---|\n| \"Invalid interval\" | Seconds not ms | Use ms: `1000`, `5000`, `30000`, `60000`, `300000`, `1800000`, `3600000`, `86400000`. Hourly = `3600000` |\n| Market cap wrong order | Default returns rank 1 first | Pass `order:\"DESC\"` explicitly for \"top N\" queries |\n| `get_market_depth` 6.8 MB | Missing pair filters | `sourceIds` (comma-separated OK, e.g. `\"4001,4002\"` = one record per source) + `baseAssetCodes` + `counterAssetCodes` |\n| `list_assets` 500 | Bare comma-separated `lukkaAssetIds`/`expandDetails` | Wrap value in square brackets: `[LA1,LA2]`, `[ALL]` |\n| `get_latest_index_prices` 404 | Reference Rate access required | Available with Lukka Reference Rate access - request at https://lukka.tech/plugin. Standard path: `get_latest_prices({ sourceId: 2000 })` for realtime or `{ sourceId: 1000 }` for EOD |\n| COINBASE not canonical | `get_entity_by_code(\"COINBASE\")` does not resolve to the exchange | Use `CPRO` (Coinbase Pro), `CBSE`, `CPRM` (Coinbase Prime) |\n| Wrong blockchain case | `eth` vs `ETH` | uda=lowercase, aml=UPPERCASE |\n| Solana wrong code | Name lookups return an unrelated same-ticker ERC-20 token | Solana = `SOLN` (not SOL). Use known canonical codes |\n| `generateAmlSimplifiedReport` wrong chain | Each tier supports specific chains | Use the tier matching your chain: SCORING (all chains), STANDARD/ENHANCED (30 chains), SIMPLIFIED (80 chains) - see [aml](references/aml.md) for full lists |\n| `getNews` date filter rejected | Date not full ISO 8601 | Use full ISO 8601: `2026-04-01T00:00:00Z` |\n| `generateAmlStandardReport` context overflow | 325 KB+ payload | Pipe through `large-data-processing/process_aml_report.py` |\n| `get_address_transactions` context overflow | limit=1000 verbose | Preview at limit<=100, bulk via `process_transactions.py` |\n| `get_core_asset_scores` empty | Missing fromDate+toDate | Pass both ISO 8601 parameters |\n\n---\n\n**Deep-dive references**: [pricing](references/pricing.md) - [refdata](references/refdata.md) - [analytics](references/analytics.md) - [aml](references/aml.md) - [uda](references/uda.md) - [news](references/news.md) - [predmar](references/predmar.md)\n"
}