{"source":"sap-mcp-pricing-registry","version":1,"strictTools":true,"currency":"USD","tiers":{"free":{"paymentRequired":false,"pricingRule":"No x402/pay.sh payment challenge. Free calls cover MCP handshake, tool/schema discovery, runtime bootstrap, cost estimation, repair planning, local payment bridge control, payment-readiness balances, single-asset price snapshots, local memory, and transaction preflight.","examples":["initialize","tools/list","sap_agent_start","sap_agent_runtime_status","sap_prepare_action","sap_agent_next_action","sap_pricing_catalog","sap_estimate_tool_cost","sap_payments_readiness","sol_get_balance","spl-token_getTokenAccounts","jupiter_getPrice","sap_decode_transaction","sap_preview_transaction"]},"micro-read":{"paymentRequired":true,"priceUsd":0.005,"pricingRule":"Flat micro-read fee for fresh lightweight hosted data beyond readiness. Use these for exact agent/profile reads, compact directory pages, SNS availability checks, escrow state, and lightweight trader context.","examples":["sap_agent_context","sap_get_agent_profile","sap_list_agents limit<=20 view=compact","sap_sns_check_domain","sap_perp_trade_plan","sap_chart_ohlc"]},"read-premium":{"paymentRequired":true,"priceUsd":0.005,"pricingRule":"Flat premium read/discovery fee per tool call. Broad scans, enriched directory views, analytics, OHLCV/history, quotes/routes, and large pages are paid. Narrow filters, small limits, and pagination are expected.","examples":["sap_discover_agents","sap_list_all_agents","sap_list_agents view=full","jupiter_getQuote","pyth_getPriceHistory","das_getAsset"]},"builder":{"paymentRequired":true,"priceUsd":0.01,"pricingRule":"Flat builder fee for unsigned transaction builders, batched domain checks, payment-header builders, routing builders, and complex pre-execution preparation.","examples":["sap_escrow_build_create_transaction","sap_sns_build_manage_record_transaction","sap_perp_build_order_transaction","jupiter_swapInstructions"]},"value-action":{"paymentRequired":true,"priceUsd":0.05,"pricingRule":"Standard value-action calls are fixed at $0.05. Heavy execution paths are fixed at $0.035. Optional notional bps is 100, then clamped between $0.005 and $1000. sap_payments_fund_prepaid is exact-priced: the x402 charge equals amountUsd because it becomes hosted prepaid credit.","examples":["jupiter_getOrder","jupiter_swap","magicblock_swap","sap_create_escrow_v2","sap_submit_signed_transaction","sap_payments_fund_prepaid amountUsd=0.25"]},"batch":{"paymentRequired":true,"pricingRule":"Sum paid calls in the JSON-RPC batch, then clamp the aggregate between $0.005 and $1000.","examples":["JSON-RPC batch with sap_discover_agents + sap_sns_batch_check_domains"]}},"toolSets":{"free":["coingecko_getTokenPrice","jupiter_getPrice","magicblock_balance","pyth_getPrice","sap_adrena_simulate_position","sap_agent_identity_plan","sap_agent_next_action","sap_agent_runtime_status","sap_agent_standard_context","sap_agent_start","sap_audit_query","sap_audit_record","sap_audit_stats","sap_decode_transaction","sap_estimate_tool_cost","sap_export_agent_oasf","sap_hermes_recent","sap_hermes_search","sap_memory_prune","sap_memory_recall","sap_memory_record","sap_memory_search","sap_memory_summarize","sap_payments_call_external_x402","sap_payments_call_paid_tool","sap_payments_finalize_transaction","sap_payments_prepaid_balance","sap_payments_prepare_challenge","sap_payments_profile_current","sap_payments_readiness","sap_payments_register_agent","sap_payments_sign_challenge","sap_payments_start_prepaid","sap_payments_update_agent","sap_payments_verify_receipt","sap_payments_wallet_guard","sap_perp_builder_status","sap_perp_fear_greed","sap_perp_portfolio_risk","sap_perp_risk_check","sap_premium_metrics","sap_premium_plugin_catalog","sap_premium_plugin_template","sap_premium_session_start","sap_premium_session_status","sap_premium_stream_flush","sap_premium_stream_poll","sap_premium_validate_plugin_manifest","sap_premium_webhook_relay_status","sap_prepare_action","sap_prepare_mandate","sap_preview_transaction","sap_pricing_catalog","sap_profile_current","sap_profile_list","sap_profile_public_key","sap_protocol_invariants","sap_quick_context","sap_runtime_repair_plan","sap_skills_bundle","sap_skills_install","sap_skills_list","sap_skills_upgrade_plan","sap_strategy_activate","sap_strategy_execute","sap_strategy_list","sap_strategy_load","sap_strategy_save","sap_stream_buffer","sap_stream_catalog","sap_stream_consume","sap_stream_replay","sap_trade_journal","sap_trade_journal_query","sap_webhook_catalog","sap_x402_calculate_cost","sap_x402_estimate_cost","sap_x402_get_balance","sol_get_balance","spl-token_getBalance","spl-token_getMint","spl-token_getSupply","spl-token_getTokenAccount","spl-token_getTokenAccounts"],"microRead":["sap_adrena_get_custody_info","sap_adrena_get_markets","sap_adrena_get_mutagen","sap_adrena_get_mutagen_leaderboard","sap_adrena_get_pool_info","sap_adrena_get_position_status","sap_adrena_get_positions","sap_adrena_get_prices","sap_adrena_get_trader_info","sap_adrena_get_trader_leaderboard","sap_adrena_get_trading_prices","sap_agent_context","sap_chart_indicators","sap_chart_long_term","sap_chart_multi_ohlc","sap_chart_ohlc","sap_chart_volume_profile","sap_fetch_capability_index","sap_fetch_protocol_index","sap_fetch_tool_category_index","sap_find_tools_by_category","sap_get_agent","sap_get_agent_profile","sap_get_agent_stats","sap_get_global_state","sap_get_network_overview","sap_get_tool_category_summary","sap_is_agent_active","sap_market_snapshot","sap_perp_funding_history","sap_perp_liquidation_zones","sap_perp_markets","sap_perp_position_info","sap_perp_signal_score","sap_perp_trade_plan","sap_sns_check_domain","sap_x402_fetch_escrow","sap_x402_has_escrow"],"conditionalFree":[],"conditionalMicroRead":["sap_list_agents"],"readPremium":["coingecko_getOHLCV","coingecko_getPoolsByToken","coingecko_getTokenInfo","coingecko_getTopGainersLosers","coingecko_getTrending","das_getAsset","das_getAssetsByCollection","das_getAssetsByCreator","das_getAssetsByOwner","das_searchAssets","jupiter_getHoldings","jupiter_getQuote","jupiter_getTokenInfo","jupiter_getTokenList","jupiter_programLabels","jupiter_searchTokens","magicblock_swapQuote","pyth_getPriceHistory","pyth_listPriceFeeds","sap_discover_agents","sap_fetch_tool","sap_list_all_agents","sap_network_stats","sap_sns_check_ownership","sap_sns_get_domain_pda","sap_sns_get_domain_records","sap_sns_get_record","sap_sns_get_record_pda","sap_sns_resolve_domain","sap_sns_resolve_wallet"],"builders":["jupiter_swapInstructions","magicblock_deposit","magicblock_initializeMint","magicblock_requestRandomness","magicblock_transfer","magicblock_withdraw","sap_adrena_build_add_limit_order","sap_adrena_build_add_liquid_stake","sap_adrena_build_add_liquidity","sap_adrena_build_add_locked_stake","sap_adrena_build_cancel_limit_order","sap_adrena_build_cancel_stop_loss","sap_adrena_build_cancel_take_profit","sap_adrena_build_claim_stakes","sap_adrena_build_close_commodity_long","sap_adrena_build_close_commodity_short","sap_adrena_build_close_long","sap_adrena_build_close_short","sap_adrena_build_init_user_staking","sap_adrena_build_modify_position","sap_adrena_build_open_commodity_long","sap_adrena_build_open_commodity_short","sap_adrena_build_open_long","sap_adrena_build_open_short","sap_adrena_build_position_package","sap_adrena_build_remove_liquid_stake","sap_adrena_build_remove_liquidity","sap_adrena_build_set_stop_loss","sap_adrena_build_set_take_profit","sap_adrena_build_swap","sap_adrena_build_trailing_stop","sap_adrena_trade_intent","sap_build_sol_transfer","sap_build_spl_transfer","sap_escrow_build_close_transaction","sap_escrow_build_create_transaction","sap_escrow_build_deposit_transaction","sap_escrow_build_finalize_transaction","sap_escrow_build_settle_transaction","sap_escrow_build_withdraw_transaction","sap_perp_build_order_transaction","sap_sns_batch_check_domains","sap_sns_build_manage_record_transaction","sap_sns_build_set_primary_domain_transaction","sap_sns_validate_records","sap_x402_build_headers_from_escrow","sap_x402_build_payment_headers"],"valueActions":["jupiter_cancelDCA","jupiter_cancelLimitOrder","jupiter_cancelLimitOrders","jupiter_createDCA","jupiter_createLimitOrder","jupiter_executeDCA","jupiter_executeOrder","jupiter_executeTrigger","jupiter_getOrder","jupiter_smartSwap","jupiter_swap","magicblock_swap","sap_payments_fund_prepaid","sap_x402_prepare_payment","sap_x402_settle","sap_x402_settle_batch"],"heavyValueActions":["jupiter_executeDCA","jupiter_executeOrder","jupiter_executeTrigger","magicblock_swap","sap_x402_settle_batch"],"valueActionPrefixes":["sap_cancel","sap_close","sap_create","sap_deactivate","sap_deposit","sap_file","sap_finalize","sap_fund","sap_publish","sap_reactivate","sap_register","sap_settle","sap_sign","sap_sns_register","sap_submit","sap_update","sap_withdraw"]},"runtimeRules":["The x402 Payment Required challenge is the final source of truth for paid hosted calls.","Free tools include control-plane calls, local bridge readiness, SOL/SPL/x402 balance checks, MagicBlock balance, and single-asset price snapshots. Use them before paid calls so agents can detect missing SOL/USDC and ask the user to top up.","Fresh hosted SAP data beyond readiness starts at the micro-read tier ($0.001): exact SAP agent/profile reads, compact directory pages, SNS availability checks, escrow state, and lightweight trader context.","Read-premium calls ($0.005) cover broad discovery, enriched holdings, token lists, OHLCV/history, DAS enrichment, quotes/routes, analytics, and larger pages. Prefer exact IDs and small limits before broad scans.","Use sap_estimate_tool_cost before any paid tool call to know the exact tier, estimated USD cost, and recommended maxPriceUsd. This avoids silent cap aborts and failed x402 attempts on local-signer-only tools.","Call sap_agent_next_action before retrying payment_required, hosted_local_signer_required, transient RPC failures, missing sap_payments, or submitted signatures that have not confirmed.","Call sap_prepare_action before swaps, registry writes, escrow, external x402 calls, premium streams, or transaction finalization. It returns the fresh-data requirements, local/hosted route, confirmation policy, retry rules, and proof-tape shape without charging x402.","Call sap_perp_builder_status before any perps execution request. Perps analytics can run from hosted data/RPC, but sap_perp_build_order_transaction is registered only when a real unsigned builder provider is configured.","Use session memory for operational context and audit only. Never use memory as cached truth for token prices, Jupiter quotes/orders, balances, blockhashes, simulations, liquidity, routes, or agent account state.","sap_list_agents compact pages with limit <= 20 are micro-read. Larger pages, full hydration, sap_discover_agents, and sap_list_all_agents are read-premium.","Use sap_payments_call_paid_tool for hosted paid tools when the runtime does not replay x402 natively.","Use sap_payments_call_external_x402 for external HTTP x402 agents discovered through SAP registry metadata.","Use hosted unsigned builders plus sap_payments_finalize_transaction for hosted non-custodial transaction flows.","Use sap_premium_plugin_catalog, sap_stream_catalog, sap_webhook_catalog, and sap_premium_session_start before premium streams/webhooks. Planning is free; live premium delivery must be activated by an x402/pay.sh delivery rail and must not be attempted when providerStatus is false.","Do not create temporary signing scripts, read keypair JSON, or call hosted signing tools for user-owned signatures.","If a hosted write returns hosted_local_signer_required, no hosted x402 payment was charged; route to the local sap_payments tool or an unsigned builder."]}