falcon.sol agents

io.github.ygfalconPublished by GitHub account ygfalconv1.0.1Updated Nov 7, 2026

Solana agent tools, x402 USDC pay-per-call (Cloudflare host).

The publisher's own server: Frontier Reference

VerifiedStreamable HTTPWeb executableFiles & Storage Finance Data & Analytics

Server details

Identifier: io.github.ygfalcon/falcon-sol
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 29, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account ygfalcon for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.ygfalcon%2Ffalcon-sol.svg)](https://sourceweft.com/mcp/io.github.ygfalcon%2Ffalcon-sol?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote pay-per-call data server for AI agents: Solana wallet and token risk checks, SEC financial comps, document extraction and crypto note pricing, paid in…

What you can do: Check Solana wallets and tokens: free previews, wallet profiles with PnL and copy-trade scores, batch screens, funding/sybil clusters, trending tokens with rug checks, and pre-trade risk checks
Screen x402 payees against sanctions and scam lists before an agent pays an unfamiliar address
Pull SEC EDGAR financials, peer suggestions, trading comps, credit and LBO models, and GPU rental price comps
Extract PDFs and bank statements, with a free first-page preview and full multi-page extraction
Price crypto structured notes and get market snapshots of spot, implied and realized volatility for BTC, ETH and SOL
Run a free health check and free teaser calls before spending anything
When to use it: Use it when an agent needs on-demand Solana wallet or token risk data, SEC-based financial analysis, document or bank-statement extraction, or crypto structured-note quotes, and you are willing to pay small per-call USDC fees instead of holding API keys.
Requirements: A remote streamable HTTP endpoint; no local install or package. An x402-capable MCP client with a funded USDC wallet on Base or Solana to pay for paid tools; free tools need no payment. Payment payload is passed in params._meta["x402/payment"]. Network access to the hosted endpoints.

Before you install

Paid tools charge USDC per call, from about $0.002 up to $4.49 for an LBO model, and prices may change, so the live 402 response is authoritative. The client must be able to sign x402 payments with a wallet. Outputs are data and model estimates, not investment advice, and should be verified. Documents and addresses you submit go to third-party hosted services.

Installation

In SourceWeft

Open falcon.sol agents in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ygfalcon%2Ffalcon-sol/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "falcon-sol-agents": {
      "type": "http",
      "url": "https://falcon-sol-agents.falcon-sol.workers.dev/mcp"
    }
  }
}

README

falcon.sol agents (public docs and manifests)

Pay-per-call data APIs for AI agents, paid with x402 (USDC on Base or Solana). This repo holds docs and discovery manifests only. It contains no server source code.

MCP endpoint (streamable HTTP): https://falcon-sol-agents.falcon-sol.workers.dev/mcp
MCP Registry: io.github.ygfalcon/falcon-sol
x402 manifest: https://falcon-sol-agents.falcon-sol.workers.dev/.well-known/x402
Full docs for LLMs: https://falcon-sol-agents.falcon-sol.workers.dev/llms-full.txt

How it behaves

Unpaid calls return HTTP 402 with the price and payment requirements.
Every paid result carries a signed Ed25519 receipt.
If the upstream source fails, the route returns 502 before settlement, so you are not charged. Bad inputs return 400/404 and are not charged.

Selected routes (live prices, USDC)

Use when	Route	Price
Before paying an unfamiliar x402 payTo	`GET https://solana-wallet-intel.falcon-sol.workers.dev/payee/check`	$0.0019
Before buying a Solana token (risk, xStock status, payee check)	`GET https://solana-wallet-intel.falcon-sol.workers.dev/pretrade`	$0.012
Probing an x402 seller for uptime, valid 402s, price/payTo drift	`GET https://falcon-sol-agents.falcon-sol.workers.dev/v1/seller/report`	$0.01
Solana wallet holdings and PnL	`GET https://solana-wallet-intel.falcon-sol.workers.dev/wallet/profile`	$0.009
Quick copy-trade screen	`GET https://solana-wallet-intel.falcon-sol.workers.dev/wallet/quick`	$0.002
xStock objection feed	`GET https://solana-wallet-intel.falcon-sol.workers.dev/xstock/feed`	$0.005
SEC financials / comps	`https://falcon-comps.falcon-sol.workers.dev`	$0.01 / $0.05
Credit model / LBO model	`https://falcon-comps.falcon-sol.workers.dev`	$0.24 / $4.49
GPU rental price comps	`POST https://falcon-comps.falcon-sol.workers.dev/v1/gpu-comps`	$0.04
Document extract / bank statement	`https://falcon-docs.falcon-sol.workers.dev`	$0.03 / $0.40
Structured-note quote	`https://falcon-structures.falcon-sol.workers.dev`	$0.02
SEC Form D leads / 8-K events	`https://deal-radar.falcon-sol.workers.dev`	$0.015 / $0.01

Free endpoints

Rug check page: https://solana-wallet-intel.falcon-sol.workers.dev/rug
x402 seller index: https://falcon-sol-agents.falcon-sol.workers.dev/sellers (JSON at /sellers.json)

Use from an MCP client

json

{ "mcpServers": { "falcon-sol": { "url": "https://falcon-sol-agents.falcon-sol.workers.dev/mcp" } } }

{ "mcpServers": { "falcon-sol": { "url": "https://falcon-sol-agents.falcon-sol.workers.dev/mcp" } } }

The npm wrapper (falcon-sol-mcp) is not published yet; use the URL above.

manifests/

Snapshots of the live discovery files (x402 manifest, MCP server card, A2A agent card, glama.json, llms.txt). The live URLs are authoritative.

Notes

Prices may change. The live 402 response is authoritative.
Not investment advice. Outputs are data and model estimates; verify before relying on them.
Built and operated by falcon.sol (GitHub ygfalcon).

Status

Docs and manifests only; no source code.

Tests

No tests (manifests only).

License

MIT. See LICENSE.

Contact

falcon.sol on GitHub: https://github.com/ygfalcon (GitHub noreply [email protected]; this address does not receive mail).

Source: README.md at commit 3f06d6b

Tools

ping

Free health check. Does not spend USDC. Confirms the MCP server is up and does not read a wallet. [falcon.sol solana-wallet-intel. Free, no payment.]

Takes no parameters.

wallet_preview

Free teaser. Call this before any paid wallet tool. Returns SOL balance, last active time, how many transactions landed in the last 24 hours, and a dormant or recently-active label. Does not spend USDC. Pass one base58 Solana address. Invalid addresses return an error and do not ask for payment. Upgrade to wallet_quick for a copy-trade screen, wallet_profile for priced holdings, or wallet_funding for the first SOL funder and cluster. [falcon.sol solana-wallet-intel. Free, no payment.]

Parametersaddressrequired

token_check_demo

Free demo. Try free, then pay per call. Pass one Solana token mint and get a real rug-check: riskScore, riskLevel, a one-line verdict, the top risk flags, liquidity, market cap, age, and pump.fun status. Uses free public data only. Cached 60 seconds per mint and rate-limited to 20 calls a minute per client. The paid routes return every flag, the full on-chain checks, and wallet intelligence. [falcon.sol solana-wallet-intel. Free, no payment.]

Parametersmintrequired

wallet_profile

Use this when you need priced holdings and windowed PnL for one Solana wallet. Holdings valued in USD, a short plain-language summary, windowed realized and unrealized PnL, win rate, and evidence-backed labels such as active memecoin trader. Includes copyTradeScore and copyTradeGrade: copy-return after a 3s delay and a 3.6% round trip, win rate, sample-size shrinkage, and bot or insider penalties. The score is null when no close lasted at least 3 seconds. txLimit is an integer from 5 to 25 and defaults to 20. Call free wallet_preview first if you only need SOL balance and last-active time, or wallet_quick for a cheaper copy-trade screen. Costs $0.009 USDC (9000 base units) via x402. The same price is charged for HTTP GET /wallet/profile. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.009 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

ParametersaddressrequiredtxLimit

wallet_funding

Use this when you need a wallet's first SOL funder and whether other wallets look like the same operator. Find a wallet's first SOL funder, flag wallets that share that funder or a CEX deposit address, and return a cluster id with plain-language sybil risk reasons. Labeled exchange hot wallets are not used as a cluster. Optional peers compares up to 8 other wallets. Costs $0.009 USDC (9000 base units) via x402. The same price is charged for HTTP GET /wallet/funding. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.009 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parameterspeersaddressrequired

wallet_quick

Use this for a cheap copy-trade screen before paying for a full profile. Cheap copy-trade screen for one wallet: windowed realized PnL, win rate, closed trades, last active time, bot, exchange, net-winner and dormant flags, plus copyTradeScore and copyTradeGrade (copy-return after a 3s delay and a 3.6% round trip, win rate, sample-size shrinkage, bot and insider penalties). Free teaser at /wallet/preview; full report at /wallet/profile. Costs $0.002 USDC (2000 base units) via x402. The same price is charged for HTTP GET /wallet/quick. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.002 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersaddressrequired

wallet_quick_batch

Quick screen (windowed realized PnL, win rate, copyTradeScore, copyTradeGrade, bot, exchange, net-winner and dormant flags) for up to 10 Solana wallets in one paid call, ranked by realized PnL. Pass addresses comma-separated. Costs $0.015 USDC (15000 base units) via x402. The same price is charged for HTTP GET /wallet/quick/batch. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.015 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersaddressesrequired

payee_check

Call this before your agent pays an unfamiliar x402 payTo address or endpoint. Checks public sanctions lists (OFAC SDN crypto addresses), the ScamSniffer scam list, on-chain wallet age, activity and program status on Solana or Base, and optionally the endpoint's unpaid 402 challenge (payTo mismatch, price outliers). Returns verdict ok, caution, do_not_pay or unknown, a 0-100 score, flags with evidence, and missing_fields. Unknown is never reported as safe. If every source is unreachable the call returns HTTP 502 and you are not charged. Part of the agent spend firewall bundle (payee_check + seller_report + pretrade); see /.well-known/x402 bundles. Costs $0.0019 USDC (1900 base units) via x402. The same price is charged for HTTP GET /payee/check. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.0019 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

ParameterspayTorequiredpricenetworkendpoint

pretrade

Call this before your agent buys a Solana token. One call runs five isolated checks: token risk (sell-side skim and fee/hook controls), top-holder concentration (the factor behind our bundle score), stablecoin lookalike detection, xStock status (issuer mint list, lookalikes and issuer objections), and optionally an x402 payee check (verdict ok, caution, do_not_pay or unknown). Unknown mints return HTTP 404 before payment. Returns verdict avoid, caution, ok or unknown, each factor's status and confidence, and plain limits. A slow or failed factor returns unknown; unknown is never ok. Capped at 3 seconds. If every factor fails the call returns HTTP 502 and you are not charged. Part of the agent spend firewall bundle (payee_check + seller_report + pretrade); see /.well-known/x402 bundles. Costs $0.012 USDC (12000 base units) via x402. The same price is charged for HTTP GET /pretrade. An unpaid HTTP call returns 402 even when the query is missing or invalid. A signed call with invalid arguments is rejected before settlement and is not charged. A successful result can set cached, stale, and cacheAgeMs. stale true means a previous result was served while a refresh runs or the upstream failed. You are charged only when the tool result is not an error. [falcon.sol solana-wallet-intel. Paid: $0.012 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

ParametersmintrequiredpayTosymbolnetworkendpoint

preview_financials

falcon.sol: Free: latest fiscal-year revenue and net income for a US ticker or CIK, from SEC EDGAR. [falcon.sol comps. Free, no payment.]

Parameterstickerrequired

suggest_peers

falcon.sol: Free: SIC-based peer tickers for a US company, ranked by revenue closeness, ready to pass to get_comps. [falcon.sol comps. Free, no payment.]

Parameterslimittickerrequired

get_financials

falcon.sol: Standardized financials (up to 15 FY + TTM, balance sheet, ratios, XBRL provenance) from SEC EDGAR. Costs $0.01 USDC (x402). [falcon.sol comps. Paid: $0.01 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersyearstickerrequired

get_comps

falcon.sol: Trading comps table (market cap, EV, EV/Revenue, EV/EBITDA, P/E, P/FCF, margins, peer medians) for up to 12 tickers. Costs $0.05 USDC (x402). [falcon.sol comps. Paid: $0.05 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parameterspricestickersrequired

get_credit

falcon.sol: Lev-fin credit comps (leverage, coverage, FCF/debt, debt capacity, rated structures, memo) for up to 12 tickers. Costs $0.24 USDC (x402). [falcon.sol comps. Paid: $0.24 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parameterspricestickersrequiredassumptions

get_lbo

falcon.sol: LBO snapshot (sources & uses, 3 structures, IRR/MOIC, IRR grid, memo) for a US ticker, exit at peer-median EV/EBITDA. Costs $4.49 USDC (x402). [falcon.sol comps. Paid: $4.49 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parameterspeerspricetickerrequiredassumptionsexit_multiple

get_gpu_comps

falcon.sol: Listed USD per GPU-hour comps (RunPod, Modal, Lambda, CoreWeave public price pages) with source URLs, fetched_at, min/median/max and quote percentile. Costs $0.04 USDC (x402). [falcon.sol comps. Paid: $0.04 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersgpustierstarget_usd_per_gpu_hr

preview_document

Free: extract page 1 of a PDF (auto-detects invoice/receipt/PO/W-9/bank statement) with per-field confidence. [falcon.sol docs. Free, no payment.]

Parametersurltypefile_base64

extract_document

Full extraction of all pages. Costs $0.03 USDC (x402). [falcon.sol docs. Paid: $0.03 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersurltypefile_base64

spread_bank_statement

Bank statement → every transaction + underwriting metrics (ADB, NSF, MCA/loan positions, revenue trend, DSCR inputs, tamper flags). Costs $0.40 USDC (x402). [falcon.sol docs. Paid: $0.40 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

Parametersurltypefile_base64

preview_note

Free indicative quote: fair coupon/participation rounded to 0.5%, probabilities, payoff diagram. [falcon.sol structures. Free, no payment.]

ParameterstermSheetrequired

market_snapshot

Free: live spot, Deribit implied vol (DVOL) and 30d realized vol for BTC, ETH or SOL. [falcon.sol structures. Free, no payment.]

Parametersunderlyingrequired

price_note

falcon.sol structures: structured-note pricing for crypto. Send a JSON term sheet (autocallable, barrier reverse convertible, range accrual, principal-protected, shark fin) on BTC, ETH or SOL; get the fair coupon or participation, probabilities (autocall per observation, knock-in, loss), greeks, a spot x vol scenario grid and payoff-diagram data. Monte Carlo on live Deribit implied vol. Free preview; full quote $0.02 USDC via x402 on Solana or Base. Costs $0.02 USDC (x402). [falcon.sol structures. Paid: $0.02 USDC per call via x402 (Base or Solana). Unpaid calls return x402 PaymentRequirements; pay with an x402-MCP client (_meta "x402/payment") and retry.]

ParameterstermSheetrequired

Version history

v1.0.1LatestOct 30, 2026
v1.0.0Oct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
LicenseNot applicable
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Falcon integrations

Frontier Reference

so.falconOfficial publisher

A remote reference server offering frontier-design facts: file formats, converters, definitions, sensors, companies, and design jobs.

Streamable HTTPWeb executable

Knowledge & Memory7 toolsOct 24, 2026

Falcon Shield

Published by GitHub account ygfalcon

Pre-sign Solana tx guard for agents: ALLOW/WARN/BLOCK verdict, x402 USDC pay-per-call.

Streamable HTTPWeb executable

1 toolOct 30, 2026

falcon.sol structures

Published by GitHub account ygfalcon

Price crypto structured notes (autocallables, shark fins, range accruals) via Monte Carlo; x402.

Streamable HTTPWeb executable

Finance3 toolsOct 30, 2026

falcon.sol docs: bank statement extraction for agents (x402)

Published by GitHub account ygfalcon

falcon.sol docs: bank statement extraction for agents (x402)'s hosted MCP server; no sign-in required; Streamable HTTP; 4 tools.

Streamable HTTPWeb executable

Finance4 toolsOct 30, 2026

falcon.sol comps

Published by GitHub account ygfalcon

falcon.sol: SEC EDGAR financials, trading comps, credit and LBO via x402 (free preview).

Streamable HTTPWeb executable

Finance7 toolsOct 30, 2026

falcon.sol agents

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

falcon.sol agents (public docs and manifests)

How it behaves

Selected routes (live prices, USDC)

Free endpoints

Use from an MCP client

manifests/

Notes

Status

Tests

License

Contact

Tools

ping

wallet_preview

token_check_demo

wallet_profile

token_trending

wallet_funding

wallet_quick

wallet_quick_batch

payee_check

pretrade

preview_financials

suggest_peers

get_financials

get_comps

get_credit

get_lbo

get_gpu_comps

preview_document

extract_document

spread_bank_statement

preview_note

market_snapshot

price_note

Version history

Score

Other Falcon integrations

Frontier Reference

Falcon Shield

falcon.sol structures

falcon.sol docs: bank statement extraction for agents (x402)

falcon.sol comps