# Allways > Allways swaps any listed asset for any other across chains, including Bittensor subnet alpha. No account, no API key, no wallet connection: you get a quote, open a swap, send the deposit, and the received asset is paid to your address. Run by Ventura Labs. Agents can use Allways three ways. Prefer the MCP server. - [llms-full.txt](https://all-ways.io/llms-full.txt): this file plus setup for each client and an HTTP quickstart. The same as a page: https://all-ways.io/agents. - [skill.md](https://all-ways.io/skill.md): the swap flow as an Agent Skill. Install for Claude Code: `mkdir -p ~/.claude/skills/allways && curl -fsSL https://all-ways.io/skill.md -o ~/.claude/skills/allways/SKILL.md`. ## MCP server - Endpoint: `https://all-ways.io/mcp` (Streamable HTTP, stateless, POST only, no auth). - Server card: `https://all-ways.io/.well-known/mcp.json`. Official MCP registry name: `io.all-ways/allways`. - Swap tools: `find_asset`, `get_quote`, `create_swap`, `get_swap`, `wait_for_swap`, `build_deposit_tx`, `report_swap_problem`. - Prompt: `swap {from, to, amount}` renders the complete safe swap flow. - Referral tools: `start_referral_sign_in`, `finish_referral_sign_in`, `create_referral_code`, `get_my_referrals`. The leaderboard and the payout log are HTTP only. - Client config, for clients that take a JSON server list: ```json { "mcpServers": { "allways": { "type": "http", "url": "https://all-ways.io/mcp" } } } ``` ## HTTP API - [OpenAPI spec](https://all-ways.io/openapi.json): every route, field and error. - API catalog (RFC 9727): `https://all-ways.io/.well-known/api-catalog` links the spec, the docs and the MCP server card. - `GET /api/assets?q=usdc+arbitrum`: find asset ids, best match first. `/api/catalog` lists everything but is large. - `POST /api/quotes` `{from, to, amount, side?}`: `side` is `send` (default) or `receive`. Rates float: the payout follows the market when the deposit arrives. - `POST /api/swaps` `{from, to, amount, expectedOut, payout, refund, referralCode?}` with an `Idempotency-Key` header: opens the swap and returns the deposit address. - `GET /api/swaps/{id}`: read the current status. Over MCP, prefer `wait_for_swap`, which returns on a status change or timeout. - `POST /api/swaps/{id}/deposit-tx` `{from?, version?}`: Solana and TAO only. Solana returns `transaction`, the deposit as a base64 unsigned transaction for the `from` wallet to sign and send. `version` is `"legacy"` (default) or `0`; send `0` for a wallet that only sends version 0 transactions, such as Trust Wallet. TAO takes an empty body `{}` and returns `call` and `node`: see "Send TAO". - `POST /api/swaps/{id}/report` `{category, message, contact?, depositTx?, amountDelivered?}`: report a problem. Categories: `not_received`, `wrong_amount`, `refund`, `slow`, `stats_wrong`, `other`. `depositTx` (your deposit transaction) goes only with `not_received`; `amountDelivered` (what arrived, a decimal) only with `wrong_amount`. - Swap page for a human: `https://all-ways.io/swap/{id}`. ## Swap flow 1. Find the asset ids for both sides. An id names the chain and the token, e.g. USDC on Arbitrum is a different id from USDC on Solana. Always confirm the chain with the user. 2. Quote. Amounts are exact decimal strings in whole units ("0.5", not lamports or wei). Respect `min` and `max`. Quotes explain the chosen route with the provider display name. 3. Open the swap with the quote's `amountIn`, as `expectedOut` the `amountOut` of `best`, and a `refund` address. It never opens for less; a `409 rate_changed` carries the new `amountOut` to re-confirm. 4. Send exactly `amountIn` of the `from` asset to `deposit.address`, on the `from` asset's chain, before `expiresAt`. - EVM: `deposit.tx` is that payment as an unsigned transaction `{chainId, to, value, data}`. Hand it to the wallet unchanged; the wallet adds nonce and gas. `value` is wei as a 0x hex quantity. For a token, `to` is the token contract and `data` is the ERC-20 transfer to the deposit address. - Solana: `POST /api/swaps/{id}/deposit-tx` (MCP `build_deposit_tx`) with the paying address builds the unsigned transaction: a SOL transfer or an SPL `transferChecked`, plus the memo if the deposit has one. Sign and send it within about a minute, or build a new one. - TAO: see "Send TAO" below. - `deposit.uri` is the same payment as a link, for wallets that read one: BIP21 on Bitcoin, Solana Pay on Solana, EIP-681 on EVM. Other networks have no `uri`: send by hand. - `tx` and `uri` are present only while the status is `awaiting_deposit` and before `expiresAt`. Allways never signs or sends: your wallet does. 5. Wait for the swap. Terminal statuses: `finished`, `refunded`, `failed`, `expired`. `payoutTx` / `refundTx` hold the on-chain transactions. Swap responses include the provider display name, but never provider order ids or internal client references. ### Send TAO A TAO deposit is a plain transfer from a Bittensor coldkey. `amountIn` is already whole TAO: pass it as it is, never as rao. - btcli: `btcli tx transfer --dest --amount-tao -w `. Run it with `--dry-run` first to preview. - bittensor Python SDK: `sub = bt.Subtensor(); intent = bt.Transfer(dest_ss58="", amount_tao=); sub.plan(intent, wallet); sub.execute(intent, wallet)`. - Your own Substrate signer: `POST /api/swaps/{id}/deposit-tx` (MCP `build_deposit_tx`) returns `call` `{method, args, callHex}` and `node`. `callHex` is the SCALE-encoded `Balances.transfer_keep_alive` call, not a signed extrinsic: check `args` (`dest` is the deposit address, `value` is `amountIn` in rao), sign it with the paying coldkey and submit it to `node`. - Both tools keep the paying account alive by default. Send once, by one of these. - Bittensor's own agent docs: [llms.txt](https://www.bittensor.com/llms.txt), [agents](https://www.bittensor.com/docs/agents). ## Get TAO Swap USDC on Base for native TAO with the swap flow above: - From: `eip155:8453/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` (USDC on Base). - To: `polkadot:2f0555cc76fc2840a25a6ea3b9637146/native` (TAO on Bittensor). - Human swap: `https://all-ways.io/?from=eip155%3A8453%2F0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&to=polkadot%3A2f0555cc76fc2840a25a6ea3b9637146%2Fnative`. ## Referrals Referrers earn on swaps opened with their code. A referrer account is a Bittensor coldkey, and rewards are paid to it. Self-referral is allowed: an agent may pass its own code on its own swaps. 1. `POST /api/auth/wallet/challenge` `{address}` returns a `message`. Sign it with the coldkey. 2. `POST /api/auth/wallet/verify` `{address, nonce, signature, bearer: true}` returns a `token`, valid 30 days. 3. `POST /api/me/referral-codes` with `Authorization: Bearer ` makes a random code. Custom codes are set up by the Allways team. 4. Pass the code as `referralCode` when opening swaps. `GET /api/me/referral-codes` shows swaps, volume and users per code. 5. `GET /api/referrals/leaderboard` and `GET /api/referrals/payouts` are public. ## Rules that protect the user's funds - Send on the exact chain of the `from` asset id. A deposit on another chain can be lost. - If `deposit.memo` is set, the transfer must carry that memo or destination tag. Without it the deposit cannot be matched. - Send once, by one method: `deposit.tx`, the built Solana transaction, the TAO command or call, `deposit.uri` or a manual send. Never two of them. A second send to the same deposit address is outside the quote and may need support to recover. - Give a `refund` address on the send chain when you open the swap; it is where funds return if the swap cannot complete. It is set once, at open, and never changed later. Use an address the user controls. - Generate one `Idempotency-Key` (MCP `idempotencyKey`, required) per intended swap and reuse it on every retry of that create, so a retry never opens a second swap. - Do not send after the swap expired. Open a new one. - Never ask the user for a seed phrase or private key. Allways never needs one. - `notices` on a swap flag `under_deposit`, `stuck`, `aml_hold` or `price_moved`: report them to the user. ## When something goes wrong - Report every swap problem through Allways itself: MCP `report_swap_problem`, `POST /api/swaps/{id}/report`, or "Report a problem" on the swap page. This is the support channel. A report reaches the team with the swap's diagnosis. - Report once for `stuck`, `under_deposit`, or `aml_hold`, or anything else wrong with a swap. Send the category, a 10–500 character message, and an optional reply email. - The team receives the report together with the swap's diagnosis. A repeat adds to the same case; after five entries, wait for the team instead of retrying. - Without a reply email there is no written reply. Watch the swap with `get_swap`: `status`, `refundTx`, and `reported`, which turns false when the team closes the case. - A successful report makes `reported: true` on `get_swap` while the case is open. `price_moved` does not need a report; tell the user the payout follows the market. ## Gas - Keep a little native gas on the send chain: ETH on Ethereum and Base, SOL on Solana, and so on. - Allways never pays gas. The deposit is a normal transfer from the sender's wallet, and the sender pays its network fee. ## No wallet yet? An agent needs a wallet on the send chain to make the deposit. Agent wallet providers cover EVM and Solana: | Send chain | Providers | | --- | --- | | EVM (Ethereum, Base, ...) | [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/agentic-wallet/welcome), [Privy](https://docs.privy.io/recipes/agent-integrations/agentic-wallets), [Phantom MCP server](https://docs.phantom.com/phantom-mcp-server), [Turnkey](https://docs.turnkey.com/solutions/company-wallets/agentic-wallets) | | Solana | [Privy](https://docs.privy.io/recipes/agent-integrations/agentic-wallets), [Phantom MCP server](https://docs.phantom.com/phantom-mcp-server), [Turnkey](https://docs.turnkey.com/solutions/company-wallets/agentic-wallets) | | Any other chain (Bitcoin, Bittensor, Tron, XRP, TON, ...) | Any wallet that can send on that chain works. Allways only needs one transfer of the exact amount, with the memo or tag when the deposit has one. | These links are not endorsements. Allways never holds your keys or funds. ## Limits - Selling subnet alpha and native TAO staking need a wallet signature and are not offered over MCP or the API yet. - Not available in sanctioned jurisdictions. Requests are rate limited per IP. ## Support - Swap problems: report them as above, never by email. - A question with no swap: sign in at https://all-ways.io/refer#report and use the report form there, never email. # Allways for agents Swap any listed asset for any other across chains, from any agent. No account, no API key. ## What agents can do - **Quote**: get the best rate for a pair and an amount. - **Open a swap**: get a deposit address for the exact send amount. - **Hand off the deposit**: get a payment URI or an unsigned transaction for the agent's wallet. - **Track**: read the swap until it reaches a terminal status. - **Report a problem**: send a stuck swap to the team with its diagnosis. - **Refer**: make a referral code and pass it on swaps. Allways never holds keys and never signs. The agent's own wallet sends the deposit. ## Connect The MCP server is at `https://all-ways.io/mcp` (Streamable HTTP, no auth). ### Claude Code ```bash claude mcp add --transport http allways https://all-ways.io/mcp ``` [Claude Code docs](https://code.claude.com/docs/en/mcp) ### Claude (web and desktop) 1. Open Customize > Connectors. 2. Click "+ Add", then "Add custom connector". 3. Enter the name `Allways` and the URL `https://all-ways.io/mcp`, then continue. 4. Set Authentication to "No sign in", then click "Add". On Team and Enterprise plans an owner adds it under Organization settings > Connectors. [Claude docs](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) ### Cursor Add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project: ```json { "mcpServers": { "allways": { "url": "https://all-ways.io/mcp" } } } ``` Or use the install link: [Add Allways to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=allways&config=eyJ1cmwiOiJodHRwczovL2FsbC13YXlzLmlvL21jcCJ9). [Cursor docs](https://cursor.com/docs/context/mcp) ### ChatGPT 1. In ChatGPT on the web, open Plugins. 2. Select the plus button, then "Add custom MCP server". 3. Enter the name `Allways` and the server URL `https://all-ways.io/mcp`. 4. Choose no authentication, accept the risk warning, then select "Create as a plugin". 5. Install the plugin, then type `@` in a chat to use it. [ChatGPT docs](https://developers.openai.com/api/docs/guides/developer-mode) ### OpenAI Codex ```bash codex mcp add allways --url https://all-ways.io/mcp ``` Or add this to `~/.codex/config.toml`: ```toml [mcp_servers.allways] url = "https://all-ways.io/mcp" ``` [Codex docs](https://developers.openai.com/codex/mcp) ### Any other client For clients that take a JSON server list: ```json { "mcpServers": { "allways": { "type": "http", "url": "https://all-ways.io/mcp" } } } ``` ### Agent Skill For agents that load skills (Claude Code and others), install the swap flow as a skill: ```bash mkdir -p ~/.claude/skills/allways && curl -fsSL https://all-ways.io/skill.md -o ~/.claude/skills/allways/SKILL.md ``` ## HTTP quickstart Four calls. Amounts are decimal strings in whole units. ```bash # 1. Find the asset id for each side. curl 'https://all-ways.io/api/assets?q=usdc+base' # 2. Quote. Keep amountIn and best.amountOut. curl -X POST https://all-ways.io/api/quotes \ -H 'content-type: application/json' \ -d '{"from":"","to":"","amount":"100"}' # 3. Open the swap. Reuse the same Idempotency-Key on a retry. curl -X POST https://all-ways.io/api/swaps \ -H 'content-type: application/json' \ -H 'Idempotency-Key: ' \ -d '{"from":"","to":"","amount":"","expectedOut":"","payout":{"address":""},"refund":{"address":""}}' # 4. Read the swap until its status is finished, refunded, failed or expired. curl https://all-ways.io/api/swaps/ ``` The opened swap tells the agent how to send the deposit: - `deposit.address`: send exactly `amountIn` here, with `deposit.memo` if it is set. - `deposit.uri`: the same deposit as a payment URI, for a wallet that takes one. - `deposit.tx` (EVM): the deposit as an unsigned transaction. Hand it to the wallet to sign and send. - `POST /api/swaps/{id}/deposit-tx` (Solana): returns the deposit as an unsigned transaction. Hand it to the wallet to sign and send. - `POST /api/swaps/{id}/deposit-tx` (TAO): returns the deposit as an unsigned call. Or send it with `btcli tx transfer --dest --amount-tao `; `amountIn` is whole TAO. ## Links - [llms.txt](https://all-ways.io/llms.txt): the short guide for agents. - [llms-full.txt](https://all-ways.io/llms-full.txt): llms.txt plus this page. - [skill.md](https://all-ways.io/skill.md): the swap flow as an Agent Skill. - [openapi.json](https://all-ways.io/openapi.json): every route, field and error. - [/.well-known/mcp.json](https://all-ways.io/.well-known/mcp.json): the MCP server card.