SoFinance

List same-stock LP pools on Raydium and Meteora, with 7-day fee APR estimates. Fees not guaranteed.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
99%
Vollständigkeit des Schemas
96%
Qualität der Benennung
91%
Risiko der Vergiftung
60%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainin list_rwa_pairs
  • MEDIUMTool description contains URL to non-standard domainin get_pool_range_apr

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~4,830Tokens (Tool-Definitionen)
~1.9 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.77% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "sofinance": {
      "url": "https://sofinancelab.xyz/api/mcp"
    }
  }
}

Remote-Endpunkte

https://sofinancelab.xyz/api/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (16)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
⚪prepare_withdraw(wallet, positionMint, percent, targetUSDC, receive, ...)

Prepare a fully simulated position withdrawal with a sign link. Default receive USDC; original keeps position tokens. Supply percent (1–100) OR targetUSDC. Impact above 5% requires confirmHighImpact. For two transactions, finalize the first then call again with stage=swap, tx1Signature and previous (the complete first result).

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "positionMint": {
      "type": "string"
    },
    "percent": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "targetUSDC": {
      "type": "number"
    },
    "receive": {
      "type": "string",
      "enum": [
        "usdc",
        "token",
        "original"
      ]
    },
    "outputMint": {
      "type": "string"
    },
    "confirmHighImpact": {
      "type": "boolean"
    },
    "stage": {
      "type": "string",
      "enum": [
        "swap"
      ]
    },
    "tx1Signature": {
      "type": "string"
    },
    "previous": {
      "type": "object"
    }
  },
  "required": [
    "wallet",
    "positionMint"
  ],
  "oneOf": [
    {
      "required": [
        "percent"
      ]
    },
    {
      "required": [
        "targetUSDC"
      ]
    }
  ]
}
🔴submit_withdraw(wallet, signedTransaction, unsignedTransaction, permit, summary, ...)

Submit a wallet signed withdrawal. Verifies its HMAC permit and signature, checks expiry, and re-simulates before broadcast. Supply the unchanged summary and permit from prepare_withdraw. If the wallet appended extra instructions (e.g. Phantom Lighthouse), also pass unsignedTransaction from prepare_withdraw. High impact requires confirmHighImpact=true.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "signedTransaction": {
      "type": "string"
    },
    "unsignedTransaction": {
      "type": "string"
    },
    "permit": {
      "type": "string"
    },
    "summary": {
      "type": "object"
    },
    "confirmHighImpact": {
      "type": "boolean"
    }
  },
  "required": [
    "wallet",
    "signedTransaction",
    "permit",
    "summary"
  ]
}
🟢get_position_performance(positionMint, wallet, maxSignatures, refreshHistory, historyAfterSignatures, ...)

Compute holding-period return and realized fee APR for a Raydium CLMM position NFT from finalized history and current on-chain state (not Raydium pool 24h feeApr). Prefer token-native metrics: for same-asset RWA wrap pairs (e.g. SPCXx/SPCX) report TE in the plain/base ticker using current tick mid (1.0001^tick×10^(decA−decB)), plus raw A/B inventory, holdingDays, feeOnlyAprPct and annualizedReturnPct (HPR×365/days; feesEarned/deposited×365/days). USD is optional/secondary (Jupiter Price v3 / Raydium stable-leg, labeled current — not historical). Discovers open/increase/decrease txs via personal-position signatures + Anchor events + current equity. After submitting a position transaction, use refreshHistory=true and historyAfterSignatures to require its finalized history. Read-only.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address (from list_positions)"
    },
    "wallet": {
      "type": "string",
      "description": "Optional wallet to verify NFT ownership (does not change math)"
    },
    "maxSignatures": {
      "type": "number",
      "description": "Max personal-position signatures to scan (1-500, default 100)",
      "default": 100
    },
    "refreshHistory": {
      "type": "boolean",
      "description": "Force a fresh history read after a transaction"
    },
    "historyAfterSignatures": {
      "type": "array",
      "maxItems": 8,
      "items": {
        "type": "string",
        "pattern": "^[1-9A-HJ-NP-Za-km-z]{64,88}$"
      }
    },
    "skipPricing": {
      "type": "boolean",
      "description": "If true, skip Jupiter/Raydium USD pricing (token-native / TE metrics still computed)",
      "default": false
    }
  },
  "required": [
    "positionMint"
  ]
}
🟢get_position_range_status(positionMint, wallet, poolId)

Compute live in-range / out-of-range status for a Raydium CLMM position from the current on-chain pool price versus tickLower/tickUpper (B per 1 A). Flags when price approaches a range edge. Read-only.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address"
    },
    "wallet": {
      "type": "string",
      "description": "Optional wallet; when set it must match the Bearer token"
    },
    "poolId": {
      "type": "string",
      "description": "Optional pool override (defaults to the position's pool)"
    }
  },
  "required": [
    "positionMint"
  ]
}
🟢list_rwa_pairs(symbol, minTvl, sortBy, maxPages)

List the same-stock Solana pools on the SoFinance pools page (https://sofinancelab.xyz/app/rwa-pairs): Raydium CLMM and Meteora DLMM pools where both sides are the same stock from two issuers (e.g. TSLA/TSLAx, SPCX/SPCXx), plus the USDC/USDT pool. Served from the site's saved pools snapshot, the same list the page shows. Each pool has protocol, symbols, fee tier, TVL, 24h volume, apr7d (the highest 7-day range fee APR estimate and which of the 4 range presets it comes from: Micro, Tight, Standard, Wide), and an openPositionUrl. Filter with symbol (e.g. "TSLA"). Default order: 7-day APR, high to low. estimatedFeeAprPct / estimatedFeeAprLabel are the older pool-level 24-hour figure (last 24h fees / TVL, annualized), not a 7-day estimate; small pools can show very large values, and a pool without a 7-day estimate carries a warning. Estimates from past trading, not a promise of future fees. Fees not guaranteed. For the 4 presets of one pool call get_pool_range_apr. No wallet or token needed. Opening a position through MCP (quote_open_position / prepare_open_position) is Raydium CLMM only and needs a wallet token; Meteora pools open on the website.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Optional ticker filter, e.g. TSLA or TSLAx (case-insensitive; matches either token or the base ticker)"
    },
    "minTvl": {
      "type": "number",
      "description": "Minimum pool TVL in USD (default 0)",
      "default": 0
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "apr7d",
        "estimatedFeeApr",
        "tvl",
        "volume24h"
      ],
      "description": "Sort key (default apr7d, the 7-day estimate the site ranks by). estimatedFeeApr is the older pool-level 24h figure.",
      "default": "apr7d"
    },
    "maxPages": {
      "type": "number",
      "description": "Deprecated, ignored: the list comes from the saved snapshot."
    }
  },
  "required": []
}
🟢get_pool_range_apr(poolId)

Estimated 7-day fee APR of one listed pool (poolAddress from list_rwa_pairs, Raydium or Meteora) for each of the 4 range presets the site prices: Micro (±2 price steps), Tight (±0.05%), Standard (±0.3%), Wide (±1%). Per preset: price bounds (B per 1 A), APR %, share of the last 7 days' volume that traded inside the range, and fees per day at the site's $1,000 card basis. Also the highest-APR preset, the 7-day window, data freshness and confidence. Same saved snapshot as the pool cards on https://sofinancelab.xyz/app/rwa-pairs. New pools (too few days of data) and missing snapshots return a status with a reason and no APR. Estimates from past trading, not a promise of future fees. Fees not guaranteed. No wallet or token needed.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "poolId": {
      "type": "string",
      "description": "Pool address (poolAddress from list_rwa_pairs)"
    }
  },
  "required": [
    "poolId"
  ]
}
🟢list_positions(wallet)

List all Raydium CLMM positions and wallet assets. Returns position NFTs (with pool, ticks, liquidity) and eligible input assets (SOL, tokens) with balances. Read-only, no private keys required. Use this first to discover available positions and assets.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana wallet public key (base58, 32-44 chars)"
    }
  },
  "required": [
    "wallet"
  ]
}
🟢quote_add_liquidity(wallet, positionMint, inputMint, inputKind, amount, ...)

Get a quote for adding liquidity to a position. Estimates swap routes (Jupiter), price impact, output amounts, and immediate resale gap. Verifies NFT ownership, pool state, and balance. Read-only. Quotes expire quickly (configured TTL). Failure modes: insufficient balance, high price impact (>5%), resale floor breach, quote expiration, pool state changes.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address (from list_positions)"
    },
    "inputMint": {
      "type": "string",
      "description": "Input asset mint address (from list_positions assets)"
    },
    "inputKind": {
      "type": "string",
      "enum": [
        "native",
        "token"
      ],
      "description": "Asset kind: 'native' for SOL, 'token' for SPL tokens"
    },
    "amount": {
      "type": "string",
      "description": "Amount in token units (e.g. '1.5' for 1.5 SOL)"
    },
    "resaleFloorBps": {
      "type": "number",
      "description": "Minimum resale ratio in basis points (9500-10000, default 9900 = 1% max loss). Conservative immediate-resale protection.",
      "default": 9900
    },
    "slippageToleranceBps": {
      "type": "number",
      "description": "Add-liquidity price tolerance in basis points (0-500, multiple of 10, default 100 = 1%). Liquidity is sized so the pool price may drift this much before execution; the unused reserve stays in the wallet. Jupiter swap slippage stays fixed at 0.5%.",
      "default": 100
    }
  },
  "required": [
    "wallet",
    "positionMint",
    "inputMint",
    "inputKind",
    "amount"
  ]
}
🟡prepare_transaction(wallet, positionMint, inputMint, inputKind, amount, ...)

Prepare an unsigned, fully-simulated transaction for adding liquidity. Returns base64-encoded transaction for signing, HMAC permit, and summary. The server NEVER holds private keys. Transaction must be signed by the user/agent wallet. Includes: full simulation, 1232-byte limit check, Jupiter swap + Raydium increase_liquidity_v2, short-lived permit. Failure modes: same as quote_add_liquidity, plus simulation failure, size limit, blockhash expiry. After signing, use submit_signed_transaction.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address"
    },
    "inputMint": {
      "type": "string",
      "description": "Input asset mint address"
    },
    "inputKind": {
      "type": "string",
      "enum": [
        "native",
        "token"
      ],
      "description": "Asset kind: 'native' or 'token'"
    },
    "amount": {
      "type": "string",
      "description": "Amount in token units"
    },
    "resaleFloorBps": {
      "type": "number",
      "description": "Resale floor in basis points (9500-10000, default 9900)",
      "default": 9900
    },
    "slippageToleranceBps": {
      "type": "number",
      "description": "Add-liquidity price tolerance in basis points (0-500, multiple of 10, default 100)",
      "default": 100
    }
  },
  "required": [
    "wallet",
    "positionMint",
    "inputMint",
    "inputKind",
    "amount"
  ]
}
🟢quote_compound(wallet, positionMint, sourceSignatures)

Get a quote for compounding a position (harvest fees/rewards, swap to ratio, reinvest). Returns expected liquidity increase, swap plan, simulation results. Verifies position eligibility. Read-only. Phase one: rejects third reward tokens (no verifiable swap path). Failure modes: ineligible position, third reward token, insufficient harvested fees for minimum liquidity unit, swap plan failure.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address"
    },
    "sourceSignatures": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: prior harvest transaction signatures to merge (max 3)",
      "maxItems": 3
    }
  },
  "required": [
    "wallet",
    "positionMint"
  ]
}
🟡prepare_compound_transaction(wallet, positionMint, sourceSignatures)

Prepare an unsigned compound transaction. Returns base64 transaction, permit, and summary. Same safety as prepare_transaction: full simulation, HMAC permit, no private keys. After signing, use submit_compound_transaction.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "positionMint": {
      "type": "string",
      "description": "Position NFT mint address"
    },
    "sourceSignatures": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: prior harvest signatures (max 3)",
      "maxItems": 3
    }
  },
  "required": [
    "wallet",
    "positionMint"
  ]
}
🔴submit_signed_transaction(signedTransaction, unsignedTransaction, permit, wallet, selection, ...)

Submit a signed add-liquidity transaction. Re-verifies HMAC permit, re-reads on-chain state, re-simulates, then broadcasts. Pass signedTransaction plus every field of submitArgs from the prepare_transaction response, unchanged. Failure modes: permit mismatch, state changed (liquidity, balance, NFT), expired (time or blockhash), simulation failure. Returns transaction signature on success.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "unsignedTransaction": {
      "type": "string",
      "description": "Base64 prepared transaction from prepare_transaction. Pass this when the wallet rewrote the message (Phantom Lighthouse / ComputeBudget)."
    },
    "permit": {
      "type": "string",
      "description": "HMAC permit from prepare_transaction"
    },
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "selection": {
      "type": "object",
      "properties": {
        "positionMint": {
          "type": "string"
        },
        "inputMint": {
          "type": "string"
        },
        "inputKind": {
          "type": "string",
          "enum": [
            "native",
            "token"
          ]
        }
      },
      "required": [
        "positionMint",
        "inputMint",
        "inputKind"
      ]
    },
    "requested": {
      "type": "string",
      "description": "Requested amount from summary"
    },
    "expectedLiquidity": {
      "type": "string",
      "description": "Expected liquidity from summary"
    },
    "startingLiquidity": {
      "type": "string",
      "description": "Starting liquidity from summary"
    },
    "floorBps": {
      "type": "number",
      "description": "Resale floor basis points"
    },
    "expiresAt": {
      "type": "number",
      "description": "Expiry timestamp (ms) from summary"
    },
    "lastValidBlockHeight": {
      "type": "number",
      "description": "Block height from summary"
    },
    "rangeSide": {
      "type": "string",
      "enum": [
        "below",
        "inside",
        "above"
      ],
      "description": "Position range side from summary"
    },
    "startingBalances": {
      "type": "object",
      "properties": {
        "input": {
          "type": "string"
        },
        "a": {
          "type": "string"
        },
        "b": {
          "type": "string"
        }
      },
      "required": [
        "input",
        "a",
        "b"
      ]
    }
  },
  "required": [
    "signedTransaction",
    "permit",
    "wallet",
    "selection",
    "requested",
    "expectedLiquidity",
    "startingLiquidity",
    "floorBps",
    "expiresAt",
    "lastValidBlockHeight",
    "rangeSide",
    "startingBalances"
  ]
}
🔴submit_compound_transaction(signedTransaction, unsignedTransaction, permit, wallet, summary)

Submit a signed compound transaction. Re-verifies permit and summary, then broadcasts. Returns signature on success. Same safety as submit_signed_transaction.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "unsignedTransaction": {
      "type": "string",
      "description": "Base64 prepared transaction from prepare_compound_transaction. Pass this when the wallet rewrote the message (Phantom Lighthouse / ComputeBudget)."
    },
    "permit": {
      "type": "string",
      "description": "HMAC permit from prepare_compound_transaction"
    },
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "summary": {
      "type": "object",
      "description": "Complete summary object from prepare_compound_transaction response, unchanged (bound by the permit)"
    }
  },
  "required": [
    "signedTransaction",
    "permit",
    "wallet",
    "summary"
  ]
}
🟢quote_open_position(wallet, poolId, inputMint, inputKind, amount, ...)

Quote opening a NEW Raydium CLMM position in a pool (no existing NFT). Input SOL/USDC/pool token, amount, and a price range (presets tight ±0.05% / standard ±0.3% / wide ±1%, or custom minPrice/maxPrice in B per 1 A). Returns expected A/B after Jupiter swap-to-ratio, tick-aligned range, in/out-of-range, price impact, refundable vs non-refundable SOL rent (NFT + tick arrays), and Token-2022/freeze flags. Fails clearly on insufficient balance, >5% impact, transfer-fee/freeze, or unfunded tick arrays the wallet cannot pay. Read-only.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "poolId": {
      "type": "string",
      "description": "Raydium CLMM pool id (from list_rwa_pairs)"
    },
    "inputMint": {
      "type": "string",
      "description": "\"SOL\" or \"USDC\" (resolved to So11111111111111111111111111111111111111112 / EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v), or a mint address in the pool"
    },
    "inputKind": {
      "type": "string",
      "enum": [
        "native",
        "token"
      ],
      "description": "'native' for SOL, 'token' otherwise"
    },
    "amount": {
      "type": "string",
      "description": "Amount in token units (e.g. '1.5')"
    },
    "rangePreset": {
      "type": "string",
      "enum": [
        "tight",
        "standard",
        "wide",
        "custom"
      ],
      "description": "Default standard (±0.3% around current B-per-A price)",
      "default": "standard"
    },
    "minPrice": {
      "type": "string",
      "description": "Custom range min price (B per 1 A), required if rangePreset=custom"
    },
    "maxPrice": {
      "type": "string",
      "description": "Custom range max price (B per 1 A), required if rangePreset=custom"
    },
    "resaleFloorBps": {
      "type": "number",
      "description": "Minimum resale ratio in basis points (9500-10000, default 9900)",
      "default": 9900
    },
    "slippageToleranceBps": {
      "type": "number",
      "description": "Open-position price tolerance in basis points (0-500, default 100). Jupiter swap slippage stays 0.5%.",
      "default": 100
    }
  },
  "required": [
    "wallet",
    "poolId",
    "inputMint",
    "inputKind",
    "amount"
  ]
}
🟡prepare_open_position(wallet, poolId, inputMint, inputKind, amount, ...)

Prepare an unsigned, fully-simulated transaction that opens a new CLMM position. Prefer passing nftMint from an agent-held Keypair so the server never signs: wallet signs first, then add the mint signature on the wallet-returned tx and call submit_open_position. Without nftMint, open signUrl: the sign page generates the mint in the browser, re-prepares, wallet signs first, then the mint (the returned tx is a preview only). HMAC permit, summary, signUrl. 1232-byte limit, fresh blockhash, full simulation. Not submit_signed_transaction — this tx has two required signers.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "poolId": {
      "type": "string",
      "description": "Raydium CLMM pool id"
    },
    "inputMint": {
      "type": "string",
      "description": "Input asset mint, or \"SOL\" / \"USDC\""
    },
    "inputKind": {
      "type": "string",
      "enum": [
        "native",
        "token"
      ]
    },
    "amount": {
      "type": "string",
      "description": "Amount in token units"
    },
    "rangePreset": {
      "type": "string",
      "enum": [
        "tight",
        "standard",
        "wide",
        "custom"
      ],
      "default": "standard"
    },
    "minPrice": {
      "type": "string"
    },
    "maxPrice": {
      "type": "string"
    },
    "resaleFloorBps": {
      "type": "number",
      "default": 9900
    },
    "slippageToleranceBps": {
      "type": "number",
      "default": 100
    },
    "nftMint": {
      "type": "string",
      "description": "Client-generated position NFT mint public key. Prefer this so the server never signs. Omit only for the MCP signUrl fallback."
    }
  },
  "required": [
    "wallet",
    "poolId",
    "inputMint",
    "inputKind",
    "amount"
  ]
}
🔴submit_open_position(signedTransaction, unsignedTransaction, permit, wallet, summary)

Submit a signed open-position transaction. Re-verifies HMAC permit, re-reads pool/balances, re-simulates (sigVerify true, including the NFT-mint partial signature), then broadcasts. Pass signedTransaction plus permit, wallet, and the complete summary from prepare_open_position, unchanged. If the wallet rewrote the message (Phantom Lighthouse / ComputeBudget), also pass unsignedTransaction from prepare. Returns signature and the new positionMint.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "unsignedTransaction": {
      "type": "string",
      "description": "Base64 prepared transaction from prepare_open_position. Pass this when the wallet rewrote the message (Phantom Lighthouse / ComputeBudget)."
    },
    "permit": {
      "type": "string",
      "description": "HMAC permit from prepare_open_position"
    },
    "wallet": {
      "type": "string",
      "description": "Wallet public key"
    },
    "summary": {
      "type": "object",
      "description": "Complete summary object from prepare_open_position, unchanged (bound by the permit)"
    }
  },
  "required": [
    "signedTransaction",
    "permit",
    "wallet",
    "summary"
  ]
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet16 Tools