Skip to main content

MCP server for the BitOasis cryptocurrency exchange API

Project description

BitOasis MCP Server

An MCP (Model Context Protocol) server that exposes the BitOasis cryptocurrency exchange API as tools for AI assistants.

Quick Start

Prerequisites

  • A verified BitOasis account with an API token (generate one at Settings > Security > Token Management)

Install via uvx (recommended)

Add to your MCP client config (Claude Desktop, VS Code, Cursor, etc.):

{
  "mcpServers": {
    "bitoasis": {
      "command": "uvx",
      "args": ["bitoasis-mcp"],
      "env": {
        "BITOASIS_API_KEY": "your-api-token-here"
      }
    }
  }
}

That's it — restart your MCP client and you're ready to go.

Remote server (no install needed)

If your team hosts the BitOasis MCP server, just add the URL — nothing to install:

{
  "mcpServers": {
    "bitoasis": {
      "url": "https://mcp.bitoasis.net/sse",
      "headers": {
        "Authorization": "Bearer your-api-token-here"
      }
    }
  }
}

Install via Docker

{
  "mcpServers": {
    "bitoasis": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BITOASIS_API_KEY", "bitoasis-mcp"],
      "env": {
        "BITOASIS_API_KEY": "your-api-token-here"
      }
    }
  }
}

Available Tools

Market Data

  • get_markets — List all tokens and trading pairs
  • get_ticker — Current price for a pair (e.g. BTC-AED)
  • get_order_book — Bids and asks for a pair
  • get_trades — Recent public trade history

Account

  • get_balances — Your balances across all currencies
  • get_banks — Your registered bank accounts

Orders

  • get_orders — List orders for a pair (filter by OPEN/DONE/CANCELED)
  • get_order — Order details by ID
  • place_order — Place a limit, market, stop, or stop_limit order
  • cancel_order — Cancel an open order

Deposits

  • get_coin_deposits / get_coin_deposit — Crypto deposit history/details
  • new_coin_deposit_address — Generate a deposit address
  • get_fiat_deposits / get_fiat_deposit — Fiat deposit history/details

Withdrawals

  • get_coin_withdrawals / get_coin_withdrawal — Crypto withdrawal history/details
  • new_coin_withdrawal — Withdraw crypto to an external address
  • get_coin_withdrawal_fees — Withdrawal fees per currency
  • get_fiat_withdrawals / get_fiat_withdrawal — Fiat withdrawal history/details
  • new_fiat_withdrawal — Withdraw fiat to a registered bank
  • cancel_fiat_withdrawal — Cancel a pending fiat withdrawal

Example Prompts

"What's the current price of BTC-AED?"

"Show my open orders for ETH-AED"

"Place a SOL-AED limit buy order: 2 SOL at 1000 AED"

"What are my balances?"

Development

git clone https://github.com/bit-oasis/bitoasis-mcp.git
cd bitoasis-mcp
uv sync

Run from source:

{
  "mcpServers": {
    "bitoasis": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/bitoasis-mcp", "bitoasis-mcp"],
      "env": {
        "BITOASIS_API_KEY": "your-api-token-here"
      }
    }
  }
}

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bitoasis_mcp-0.2.0.tar.gz (53.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bitoasis_mcp-0.2.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file bitoasis_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: bitoasis_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 53.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for bitoasis_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 7a566720a03533014867ce52c4ed555e7a0bba050468e90a783f1921ee4f1632
MD5 abf2e2e939299a9ab7c3fd2a392841eb
BLAKE2b-256 f7e21dc1e3093580bdbb3d6fac3c4f701834015a8479a40e89d7cd08cfc59f3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for bitoasis_mcp-0.2.0.tar.gz:

Publisher: publish.yml on bit-oasis/bitoasis-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bitoasis_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: bitoasis_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for bitoasis_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4faa0d18cb630014550dc4d024b60acfa7eaa4d16d23f0e6060258b096978822
MD5 1217cde125439bfef7d1e19faf927440
BLAKE2b-256 7f38b1ebb222589bde8bbb5f19ecee105f76f83cfeb9abfbccb82d1d37f0bc61

See more details on using hashes here.

Provenance

The following attestation bundles were made for bitoasis_mcp-0.2.0-py3-none-any.whl:

Publisher: publish.yml on bit-oasis/bitoasis-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page