Zenidp/solinkify-mcp

MCP (Model Context Protocol) server that lets any AI agent — Claude Desktop,
Claude Code, Cursor, or your own MCP host — **pay for things on Solana through
Solinkify**, with hard spending caps. Agentic payments on the x402 standard,
as a set of tools your agent already knows how to call:
- **Gate (x402 paywalls):** find priced endpoints in the public registry,
preview prices, auto-pay HTTP 402 content, manage a pre-paid balance, buy
subscriptions.
- **DataHub:** search the dataset marketplace and buy datasets (99% goes to the
seller, download link returned).
- **Pay:** inspect and settle store checkout sessions (WooCommerce, OpenCart,
PrestaShop, hosted checkout).
- **Social Commerce:** inspect and buy products from Blink links exactly as
they circulate on X (share link, Actions URL, or raw id).
Quick start
Add to your MCP host config (e.g. Claude Desktop claude_desktop_config.json):
The wallet is a standard Solana JSON keypair (solana-keygen new -o agent-keypair.json),
funded with a little SOL for fees and the stablecoin you want to spend
(USDC/USDT).
It is optional at startup: the server connects and lists its tools with no wallet
configured, and the read-only tools (price preview, dataset search, checkout
quotes) work as they are. Only the tools that spend ask for a keypair, and they
say so in the tool result rather than failing at launch.
Docker
-i is required: stdin and stdout carry the MCP protocol.
Tools
| Tool | What it does |
|---|---|
| wallet_status | Address, SOL, stablecoin balances, prepaid balance, remaining budget |
| spend_authority_status | On-chain SpendAuthority (owner mode): caps, spent/left today, revoked |
| gate_find_endpoints | Browse the public registry of x402-priced endpoints (price, network, access modes, fits-your-cap) |
| gate_get_price | Preview an x402 paywall without paying |
| gate_fetch | Fetch gated content, auto-paying (prepaid preferred, escrow otherwise); files a signed delivery record when the gate keeps one |
| gate_check_delivery | Compare what the gate says it served with what the agent says it received |
| gate_prepaid_balance / gate_prepaid_deposit | Manage the pre-paid balance (no per-request signing) |
| gate_subscribe | Buy a creator's subscription plan (price read on-chain first) |
| datahub_search | Search the DataHub marketplace (results carry attested + quality_score) |
| datahub_buy | Buy a dataset and get the download link |
| datahub_review | Rate a dataset you bought (verified-purchase gated server-side) |
| datahub_subscribe | Time-based access to a recurring dataset (on-chain plan; renew extends expiry) |
| datahub_download | Fresh download link via purchase receipt or active subscription (no payment) |
| pay_get_session | Inspect a checkout session (accepts the full checkout URL) |
| pay_checkout | Pay a pending checkout session; the merchant's order is marked paid. With SOLINKIFY_OWNER_WALLET: spends the owner's funds under on-chain caps |
| social_get_blink | Inspect a Blink product link (title, price, seller) without paying |
| social_buy_blink | Buy from a Blink link; returns the receipt + download link |
Authorization model