{"id":51932528,"url":"https://github.com/askbeka/tentactl","last_synced_at":"2026-07-28T10:01:11.876Z","repository":{"id":340557193,"uuid":"1165999570","full_name":"askbeka/tentactl","owner":"askbeka","description":"kraken API cli, mcp and skill","archived":false,"fork":false,"pushed_at":"2026-02-26T15:07:12.000Z","size":85,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-28T02:13:04.721Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/askbeka.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-24T19:16:45.000Z","updated_at":"2026-02-26T15:10:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/askbeka/tentactl","commit_stats":null,"previous_names":["askbeka/tentactl"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/askbeka/tentactl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/askbeka%2Ftentactl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/askbeka%2Ftentactl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/askbeka%2Ftentactl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/askbeka%2Ftentactl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/askbeka","download_url":"https://codeload.github.com/askbeka/tentactl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/askbeka%2Ftentactl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35987426,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-28T02:00:06.341Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-28T10:01:11.109Z","updated_at":"2026-07-28T10:01:11.870Z","avatar_url":"https://github.com/askbeka.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐙 tentactl\n\n**Your Kraken exchange, as an AI tool.**\n\ntentactl is an [MCP server](https://modelcontextprotocol.io) that gives any AI agent — Claude, Cursor, OpenClaw, or your own — the ability to interact with the Kraken cryptocurrency exchange through natural conversation.\n\n```\nYou: \"How's my portfolio doing?\"\nAgent: You're holding 0.5 BTC ($48,250), 3.2 ETH ($9,920), and 150 SOL ($22,500).\n       Total: $80,670 — up 12.3% this month. SOL is your best performer at +28%.\n\nYou: \"Set up a weekly DCA — $100 of ETH every Monday morning\"\nAgent: I'll validate the order first...\n       ✅ Dry run passed: market buy 0.032 ETH (~$100) on ETHUSD.\n       Want me to schedule this every Monday at 9:00 AM?\n```\n\nNo dashboards. No config files. Just talk.\n\n## Why MCP?\n\nMCP (Model Context Protocol) is a standard that lets AI agents use external tools. tentactl exposes Kraken's API as MCP tools, which means:\n\n- **Any MCP client works** — Claude Desktop, Cursor, OpenClaw, or anything that speaks MCP\n- **Composable** — combine with other tools (news feeds, calendars, code) in the same agent\n- **Conversational** — no API docs to read, just describe what you want\n- **Auditable** — every action is visible in the agent's conversation log\n\n## Quick Start\n\n### Install\n\n```bash\n# From crates.io\ncargo install tentactl\n\n# Or download a binary from GitHub Releases\n# https://github.com/askbeka/tentactl/releases\n```\n\n### Configure\n\nGet API keys from [Kraken](https://www.kraken.com/u/security/api), then add tentactl to your MCP client:\n\n**Claude Desktop / Cursor:**\n```json\n{\n  \"mcpServers\": {\n    \"kraken\": {\n      \"command\": \"tentactl\",\n      \"env\": {\n        \"KRAKEN_API_KEY\": \"your-key\",\n        \"KRAKEN_API_SECRET\": \"your-secret\"\n      }\n    }\n  }\n}\n```\n\n**OpenClaw:**\n```bash\n# Install the skill\nnpx clawhub install tentactl\n\n# Set up API keys\n~/.openclaw/workspace/skills/tentactl/scripts/setup-keys.sh\n```\n\nMarket data works without API keys. Account and trading features require authentication.\n\n### Use\n\nThat's it. Ask your agent about crypto — it'll use tentactl automatically.\n\n## What You Can Do\n\n### Market Data (no auth)\n\n| Tool | What it does |\n|------|-------------|\n| `get_ticker` | Live price, volume, 24h high/low |\n| `get_orderbook` | Order book depth — asks and bids |\n| `get_ohlc` | Candlestick data for technical analysis |\n\n\u003e *\"What's the current price of ETH?\"*\n\u003e *\"Show me the BTC order book — top 10 levels\"*\n\u003e *\"Pull hourly candles for SOL over the last week\"*\n\n### Portfolio (requires auth)\n\n| Tool | What it does |\n|------|-------------|\n| `get_balance` | All holdings with current values |\n| `get_trade_history` | Past trades with P\u0026L |\n| `get_open_orders` | Pending orders |\n\n\u003e *\"What am I holding?\"*\n\u003e *\"Show my trades from last week\"*\n\u003e *\"Do I have any open limit orders?\"*\n\n### Trading (requires auth) ⚠️\n\n| Tool | What it does |\n|------|-------------|\n| `place_order` | Buy/sell — market or limit |\n| `cancel_order` | Cancel a pending order |\n\n\u003e *\"Buy 0.01 BTC at market\"*\n\u003e *\"Place a limit buy for 1 ETH at $2,800\"*\n\u003e *\"Cancel that open order\"*\n\n**Safety:** All order placements go through a validate-first flow. The agent dry-runs the order, shows you exactly what will happen, and waits for your confirmation before executing.\n\n## What Makes This Interesting\n\n### Conversational Trading\n\nTraditional flow: open app → find pair → choose order type → enter amount → review → confirm.\n\ntentactl flow: *\"Buy $100 of ETH\"* → done.\n\nThe agent handles pair format, order sizing, validation, and confirmation. You think in intent, it handles execution.\n\n### Agent-Native Automation\n\nBecause tentactl runs inside an AI agent, you get automation that understands context:\n\n**DCA with conditions:**\n\u003e *\"Buy $50 of BTC every Monday, but skip if RSI is above 70\"*\n\nThe agent pulls OHLC data, calculates RSI, and conditionally executes. No scripting required.\n\n**Smart alerts:**\n\u003e *\"Tell me if BTC drops 5% in an hour, or if my SOL position is up 20%\"*\n\nCombine price monitoring with portfolio tracking — delivered to your preferred chat (Telegram, Signal, Discord).\n\n**Portfolio intelligence:**\n\u003e *\"How's my portfolio doing this month? What's my best and worst performer?\"*\n\nThe agent combines balances, trade history, and live prices to give you an actual analysis — not just numbers.\n\n### Composable with Other Tools\n\nMCP tools compose naturally. An agent with tentactl plus other tools can:\n\n- Read crypto news → assess impact → suggest trades\n- Monitor your calendar → generate portfolio summaries before meetings\n- Run backtests in code → execute the winning strategy\n- Track on-chain events → hedge positions automatically\n\nThis is the power of MCP: tentactl doesn't need to build all of this. It just needs to be a good trading tool, and agents handle the orchestration.\n\n## Roadmap\n\n### Coming Soon\n- **WebSocket streaming** — real-time price feeds, live order status updates, instant fill notifications\n- **Staking** — stake/unstake, view rewards, auto-compound\n- **Funding** — deposits, withdrawals, address generation\n- **Full ledger** — complete transaction history, P\u0026L calculations\n\n### Planned\n- **Advanced orders** — stop-loss, take-profit, OCO (one-cancels-other), trailing stops\n- **Earn strategies** — yield optimization across Kraken's earn products\n- **Multi-account** — subaccount management for portfolio isolation\n- **Risk tools** — exposure analysis, concentration warnings, correlation tracking\n\n## Getting Kraken API Keys\n\n1. Log in to [Kraken](https://www.kraken.com)\n2. Go to **Settings → API** (or visit `https://www.kraken.com/u/security/api`)\n3. Click **Generate New Key**\n4. For read-only: enable **Query Funds** and **Query Open Orders \u0026 Trades**\n5. For trading: also enable **Create \u0026 Modify Orders**\n6. Copy the API Key and Private Key\n\n**Tip:** Create separate keys with minimal permissions. Read-only for monitoring, trade-enabled only when you need it.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `KRAKEN_API_KEY` | For spot account/trading | Spot API key ([create here](https://www.kraken.com/u/security/api)) |\n| `KRAKEN_API_SECRET` | For spot account/trading | Spot API secret |\n| `KRAKEN_FUTURES_KEY` | For futures account/trading | Futures API key ([create here](https://futures.kraken.com/trade/settings/api)) |\n| `KRAKEN_FUTURES_SECRET` | For futures account/trading | Futures API secret |\n| `RUST_LOG` | No | Log level (`info`, `debug`) — logs to stderr |\n\n## Development\n\n```bash\ncargo build\ncargo test\ncargo clippy -- -D warnings\ncargo fmt --check\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faskbeka%2Ftentactl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faskbeka%2Ftentactl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faskbeka%2Ftentactl/lists"}