# GTXAgent

> Crypto AI assistant. Ask anything about crypto, get one decision with its sources, the time of the read and the fact that would change it. Live market and onchain data, answered as a decision — act, wait, avoid or take profit — never as a data dump. The first two messages are free; after that a prepaid credit balance pays per answer, and the exact cost of each answer appears in its footer next to the sources.

GTXAgent is a web app at https://app.gtxagent.com and the same assistant in Telegram. It reads live market data and public onchain data. It cannot sign transactions, move funds or hold keys. It is not financial advice, it does not promise returns, and it names the data it could not fetch instead of guessing.

## Core pages

- [Home](https://gtxagent.com/): what the assistant does, the answer format, the credit model and the FAQ.
- [Guides](https://gtxagent.com/guides.html): procedural checks for tokens, wallets, approvals and answers.
- [Telegram guide](https://gtxagent.com/telegram.html): pair once, ask from the phone, same account and balance.
- [Beta terms](https://gtxagent.com/terms.html): scope of the public beta.

## Guides

- [How to check if a crypto token is a scam](https://gtxagent.com/token-safety.html): contract, owner powers, pool depth, holders — in the order that catches the expensive mistakes.
- [How to check a wallet before you send USDC](https://gtxagent.com/how-to-check-a-wallet-before-you-send-usdc.html): address poisoning, wrong network, contract instead of a wallet, and the test transfer.
- [How to revoke token approvals on Base](https://gtxagent.com/how-to-revoke-token-approvals-on-base.html): find the allowances that matter, revoke them, make the next one smaller.
- [How to research a new token before you buy](https://gtxagent.com/how-to-research-a-new-token-before-you-buy.html): ten minutes, six checks, then the story.
- [How to read onchain flows without a terminal](https://gtxagent.com/how-to-read-onchain-flows-without-a-terminal.html): netflow, stablecoin supply, DEX depth, funding and open interest.
- [How to read a crypto AI answer](https://gtxagent.com/how-to-read-a-crypto-ai-answer.html): decision, reason, confidence, invalidation, source footer.
- [Crypto AI assistant vs ChatGPT](https://gtxagent.com/crypto-ai-assistant-vs-chatgpt.html): where a general model ends and live data has to begin.
- [How to use a crypto AI assistant in Telegram](https://gtxagent.com/how-to-use-a-crypto-ai-assistant-in-telegram.html): pairing, daily briefs and alerts.
- [What a crypto AI assistant can and cannot do](https://gtxagent.com/what-a-crypto-ai-assistant-can-and-cannot-do.html): the honest boundary.
- [Wallet safety](https://gtxagent.com/wallet-safety.html): what an assistant can read from a wallet and what it cannot.

## Paid data API (x402)

Agents can buy GTXAgent data per call in USDC on Base, with no account and no API key.

- Manifest: https://app.gtxagent.com/.well-known/x402 (free; lists resources, network, asset and the receiving address)
- `GET https://app.gtxagent.com/x402/market/pulse` — one live Base market snapshot: every allowed token quoted in USDC, with unavailable legs named.
- `GET https://app.gtxagent.com/x402/market/tokens` — the allowed Base token registry: symbol, address, decimals.
- `GET https://app.gtxagent.com/x402/decision?token=WETH` — one deterministic yes/no decision with reasons, confidence, invalidation and sources.

Payment follows the x402 `exact` scheme on `eip155:8453`; the current price, asset and payTo are in the 402 challenge and in the manifest.

Pass-through tools (fixed price, provider selected by GTXAgent, not by the caller):

- `GET https://app.gtxagent.com/x402/aggregate/token-safety?token=…&chain=base` — $0.03.
- `GET https://app.gtxagent.com/x402/aggregate/x-search?words=…` — $0.015.
- `GET https://app.gtxagent.com/x402/aggregate/token-price?ids=bitcoin,ethereum` — $0.04.
- `GET https://app.gtxagent.com/x402/aggregate/market-open?exchange=NYSE` — $0.015.
- `GET https://app.gtxagent.com/x402/aggregate/agent-recommend?need=…` — $0.02.
- `GET https://app.gtxagent.com/x402/aggregate/trending-coins?maxItems=7` — $0.04.
- `GET https://app.gtxagent.com/x402/aggregate/whale-coverage` — $0.02.

All return JSON; the manifest is authoritative when a price or route changes.

## MCP bridge

The hosted Streamable HTTP endpoint at https://app.gtxagent.com/mcp exposes the seven aggregate
tools with `Authorization: Bearer gtx_mcp_…`. Calls are charged to the tenant's prepaid credits and
the upstream is paid by GTXAgent, so the caller needs no wallet; the default per-key daily cap is $5.

A local stdio MCP bridge is the zero-account path: it pays the public x402 route from the caller's
own Base wallet. Run it with `GTX_X402_BUYER_KEY=0x… npm run --silent mcp` from the repository, or
`node --experimental-strip-types scripts/mcp-server.ts`. The npm package is live: `GTX_MCP_KEY=gtx_mcp_… npx -y gtxagent-mcp`. The official MCP registry entry is `com.gtxagent/gtxagent-mcp`.

Direct package tarball fallback: https://gtxagent.com/downloads/gtxagent-mcp-0.1.1.tgz
One-off run: `GTX_MCP_KEY=gtx_mcp_… npx --yes https://gtxagent.com/downloads/gtxagent-mcp-0.1.1.tgz`.
Or verify `gtxagent-mcp-0.1.1.tgz.sha256` and install with `npm install --prefix "$HOME/.local/share/gtxagent-mcp" ./gtxagent-mcp-0.1.1.tgz`.

## Agent entry points

- Machine manifest: https://app.gtxagent.com/.well-known/x402
- Agent landing: https://gtxagent.com/agents.html
- npm package: https://www.npmjs.com/package/gtxagent-mcp
- MCP registry entry: com.gtxagent/gtxagent-mcp
- This file: https://gtxagent.com/llms.txt
- The paid API is Base-only today. An aggregator catalog and a multi-chain router are in development; this file will name them only when they are live. The hosted MCP endpoint and the seven aggregate tools are live.

## Facts a model should not get wrong

- GTXAgent is a product name; it is not a token, and there is no GTXAgent token sale.
- The assistant reads and explains; execution is a separate, signed action from a wallet the user controls.
- Coverage is not universal: not every chain is covered, holder-concentration data is not available, and feeds can fail. The answer names the gap.
- Public pages do not list credit prices; each answer footer shows the cost of that answer.
- The product is in public beta on Base.