Desk3 MCP Server

Instructions

Implementation Reference

• src/desk3_service/server.py:121-130 (handler)

  The primary handler function for the 'get_btc_trend' tool. It performs an HTTP GET request to the external Desk3 API to retrieve BTC trend data for the past 3 months and returns it as a list of lists.
  async def get_btc_trend() -> list[list]: """ Get BTC trend chart for the past 3 months. :return: List of [date, price, active addresses, new addresses, transaction addresses] """ url = 'https://mcp.desk3.io/v1/market/btc/trend' try: return request_api('get', url) except Exception as e: raise RuntimeError(f"Failed to fetch BTC trend data: {e}")
• src/desk3_service/server.py:600-608 (registration)

  Registration of the 'get_btc_trend' tool in the MCP server's list_tools handler, including name, description, and empty input schema (no parameters required).
  types.Tool( name="get_btc_trend", description="Get BTC trend chart for the past 3 months. Format: [[date, price, active addresses, new addresses, transaction addresses]]", inputSchema={ "type": "object", "properties": {}, "required": [], }, ),
• src/desk3_service/server.py:603-607 (schema)

  Input JSON schema for the 'get_btc_trend' tool, defining an empty object with no properties or required fields.
  inputSchema={ "type": "object", "properties": {}, "required": [], },
• src/desk3_service/server.py:784-794 (handler)

  Tool execution dispatcher in the MCP server's call_tool handler. It invokes the get_btc_trend function and formats the result as TextContent for the MCP protocol.
  case "get_btc_trend": try: data = await get_btc_trend() return [ types.TextContent( type="text", text=json.dumps(data, indent=2), ) ] except Exception as e: raise RuntimeError(f"Failed to fetch BTC trend data: {e}")
• src/desk3_service/server.py:23-42 (helper)

  Shared helper function used by get_btc_trend (and other tools) to make authenticated HTTP requests to the Desk3 API.
  def request_api(method: str, url: str, params: dict = None, data: dict = None) -> any: headers = { 'Accepts': 'application/json', 'X-DESK3_PRO_API_KEY': API_KEY, } try: logging.info(f"Requesting {method.upper()} {url} params={params} data={data}") if method.lower() == 'get': response = requests.get(url, headers=headers, params=params) elif method.lower() == 'post': response = requests.post(url, headers=headers, json=data) else: raise ValueError(f"Unsupported HTTP method: {method}") response.raise_for_status() logging.info(f"Response {response.status_code} for {url}") return json.loads(response.text) except Exception as e: logging.error(f"Error during {method.upper()} {url}: {e}") raise