# SoFinance (remote · sofinancelab.xyz)

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

- Trust score: 75/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `sofinancelab.xyz`: 75/100 (this document), [markdown](https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp.md), [page](https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp)

## Channel facts

- Endpoint: `https://sofinancelab.xyz/api/mcp`
- Transports: `streamable-http`
- Auth: `required (not validated)`
- Version: `0.2.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 58/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3592 tokens (~224/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 91/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 74% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the SoFinance MCP server?

SoFinance is a hosted endpoint at https://sofinancelab.xyz/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http xyz-sofinancelab-sofinance 'https://sofinancelab.xyz/api/mcp'
```

### Cursor

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

### VS Code

```json
{
  "servers": {
    "xyz-sofinancelab-sofinance": {
      "type": "http",
      "url": "https://sofinancelab.xyz/api/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.xyz-sofinancelab-sofinance]
url = "https://sofinancelab.xyz/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xyz-sofinancelab-sofinance": {
      "type": "remote",
      "url": "https://sofinancelab.xyz/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add xyz-sofinancelab-sofinance --url 'https://sofinancelab.xyz/api/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  xyz-sofinancelab-sofinance:
    url: "https://sofinancelab.xyz/api/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "xyz-sofinancelab-sofinance": {
      "Transport": "http",
      "Url": "https://sofinancelab.xyz/api/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add xyz-sofinancelab-sofinance -t streamable-http -u 'https://sofinancelab.xyz/api/mcp'
```

### Other

```json
{
  "mcpServers": {
    "xyz-sofinancelab-sofinance": {
      "type": "http",
      "url": "https://sofinancelab.xyz/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 75, +1)

- [security] Tool “get_pool_range_apr” rewrote its description, which is the text the model reads
- [security] Tool “list_rwa_pairs” rewrote its description, which is the text the model reads

### 2026-11-19 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-16 (score 72, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-15 (score 72)

First indexed and scored.

## MCP tools (16)

### `prepare_withdraw` (~156 tokens)

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).

Input parameters:

- `confirmHighImpact` (boolean)
- `outputMint` (string)
- `percent` (number)
- `positionMint` (string, required)
- `previous` (object)
- `receive` (string)
- `stage` (string)
- `targetUSDC` (number)
- `tx1Signature` (string)
- `wallet` (string, required)

### `submit_withdraw` (~122 tokens)

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.

Input parameters:

- `confirmHighImpact` (boolean)
- `permit` (string, required)
- `signedTransaction` (string, required)
- `summary` (object, required)
- `unsignedTransaction` (string)
- `wallet` (string, required)

### `get_position_performance` (~311 tokens)

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.

Input parameters:

- `historyAfterSignatures` (array)
- `maxSignatures` (number): Max personal-position signatures to scan (1-500, default 100)
- `positionMint` (string, required): Position NFT mint address (from list_positions)
- `refreshHistory` (boolean): Force a fresh history read after a transaction
- `skipPricing` (boolean): If true, skip Jupiter/Raydium USD pricing (token-native / TE metrics still computed)
- `wallet` (string): Optional wallet to verify NFT ownership (does not change math)

### `get_position_range_status` (~107 tokens)

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.

Input parameters:

- `poolId` (string): Optional pool override (defaults to the position's pool)
- `positionMint` (string, required): Position NFT mint address
- `wallet` (string): Optional wallet; when set it must match the Bearer token

### `list_rwa_pairs` (~416 tokens)

List same-stock pools

List the same-stock Solana pools on the SoFinance pools page (https://sofinancelab.xyz/pools): 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.

Input parameters:

- `maxPages` (number): Deprecated, ignored: the list comes from the saved snapshot.
- `minTvl` (number): Minimum pool TVL in USD (default 0)
- `sortBy` (string): Sort key (default apr7d, the 7-day estimate the site ranks by). estimatedFeeApr is the older pool-level 24h figure.
- `symbol` (string): Optional ticker filter, e.g. TSLA or TSLAx (case-insensitive; matches either token or the base ticker)

### `get_pool_range_apr` (~216 tokens)

7-day range APR for a pool

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/pools. 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.

Input parameters:

- `poolId` (string, required): Pool address (poolAddress from list_rwa_pairs)

### `list_positions` (~82 tokens)

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.

Input parameters:

- `wallet` (string, required): Solana wallet public key (base58, 32-44 chars)

### `quote_add_liquidity` (~285 tokens)

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.

Input parameters:

- `amount` (string, required): Amount in token units (e.g. '1.5' for 1.5 SOL)
- `inputKind` (string, required): Asset kind: 'native' for SOL, 'token' for SPL tokens
- `inputMint` (string, required): Input asset mint address (from list_positions assets)
- `positionMint` (string, required): Position NFT mint address (from list_positions)
- `resaleFloorBps` (number): Minimum resale ratio in basis points (9500-10000, default 9900 = 1% max loss). Conservative immediate-resale protection.
- `slippageToleranceBps` (number): 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 wal…
- `wallet` (string, required): Wallet public key

### `prepare_transaction` (~236 tokens)

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.

Input parameters:

- `amount` (string, required): Amount in token units
- `inputKind` (string, required): Asset kind: 'native' or 'token'
- `inputMint` (string, required): Input asset mint address
- `positionMint` (string, required): Position NFT mint address
- `resaleFloorBps` (number): Resale floor in basis points (9500-10000, default 9900)
- `slippageToleranceBps` (number): Add-liquidity price tolerance in basis points (0-500, multiple of 10, default 100)
- `wallet` (string, required): Wallet public key

### `quote_compound` (~130 tokens)

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.

Input parameters:

- `positionMint` (string, required): Position NFT mint address
- `sourceSignatures` (array): Optional: prior harvest transaction signatures to merge (max 3)
- `wallet` (string, required): Wallet public key

### `prepare_compound_transaction` (~92 tokens)

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.

Input parameters:

- `positionMint` (string, required): Position NFT mint address
- `sourceSignatures` (array): Optional: prior harvest signatures (max 3)
- `wallet` (string, required): Wallet public key

### `submit_signed_transaction` (~266 tokens)

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.

Input parameters:

- `expectedLiquidity` (string, required): Expected liquidity from summary
- `expiresAt` (number, required): Expiry timestamp (ms) from summary
- `floorBps` (number, required): Resale floor basis points
- `lastValidBlockHeight` (number, required): Block height from summary
- `permit` (string, required): HMAC permit from prepare_transaction
- `rangeSide` (string, required): Position range side from summary
- `requested` (string, required): Requested amount from summary
- `selection` (object, required)
- `signedTransaction` (string, required): Base64-encoded signed transaction
- `startingBalances` (object, required)
- `startingLiquidity` (string, required): Starting liquidity from summary
- `unsignedTransaction` (string): Base64 prepared transaction from prepare_transaction. Pass this when the wallet rewrote the message (Phantom Lighthouse / ComputeBudget).
- `wallet` (string, required): Wallet public key

### `submit_compound_transaction` (~134 tokens)

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

Input parameters:

- `permit` (string, required): HMAC permit from prepare_compound_transaction
- `signedTransaction` (string, required): Base64-encoded signed transaction
- `summary` (object, required): Complete summary object from prepare_compound_transaction response, unchanged (bound by the permit)
- `unsignedTransaction` (string): Base64 prepared transaction from prepare_compound_transaction. Pass this when the wallet rewrote the message (Phantom Lighthouse / ComputeBudget).
- `wallet` (string, required): Wallet public key

### `quote_open_position` (~430 tokens)

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.

Input parameters:

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

### `prepare_open_position` (~278 tokens)

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.

Input parameters:

- `amount` (string, required): Amount in token units
- `inputKind` (string, required)
- `inputMint` (string, required): Input asset mint, or "SOL" / "USDC"
- `maxPrice` (string)
- `minPrice` (string)
- `nftMint` (string): Client-generated position NFT mint public key. Prefer this so the server never signs. Omit only for the MCP signUrl fallback.
- `poolId` (string, required): Raydium CLMM pool id
- `rangePreset` (string)
- `resaleFloorBps` (number)
- `slippageToleranceBps` (number)
- `wallet` (string, required): Wallet public key

### `submit_open_position` (~192 tokens)

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.

Input parameters:

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

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp#diagnostics

## Score history

- 2026-11-21: 75
- 2026-11-20: 74
- 2026-11-19: 74
- 2026-11-18: 73
- 2026-11-17: 73
- 2026-11-16: 72
- 2026-11-15: 72

## Common questions

### What is the SoFinance MCP server?

SoFinance is an MCP server listed in the public MCP registry as xyz.sofinancelab/sofinance. List same-stock LP pools on Raydium and Meteora, with 7-day fee APR estimates. Fees not guaranteed. This page covers its hosted endpoint (https://sofinancelab.xyz/api/mcp).

### Is the SoFinance MCP server safe to use?

SoFinance scores 75 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the SoFinance MCP server expose?

SoFinance exposes 16 tools: prepare_withdraw, submit_withdraw, get_position_performance, get_position_range_status, list_rwa_pairs, and 11 more. Their descriptions and schemas cost roughly 3,453 tokens of context every time the server is loaded.

### Does the SoFinance MCP server require authentication?

Yes. SoFinance asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the SoFinance MCP server still maintained?

SoFinance is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the SoFinance MCP server?

VerifyMCP ran 13 checks on SoFinance, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://sofinancelab.xyz/api/mcp
- Website: https://sofinancelab.xyz/app/ai
- Changelog RSS feed: https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/xyz-sofinancelab-sofinance/api-mcp
