ib-async-mcp

Instructions

Implementation Reference

• src/ib_async_mcp/server.py:450-460 (handler)

  The handler logic for the 'connect' tool in _handle_tool function, which manages the connection to TWS/Gateway using IB.connectAsync.

  if name == "connect":
      if ib is not None and ib.isConnected():
          return {"status": "already_connected"}
      ib = IB()
      await ib.connectAsync(
          host=args.get("host", "127.0.0.1"),
          port=args.get("port", 7496),
          clientId=args.get("client_id", 1),
          readonly=args.get("readonly", True),
      )
      return {"status": "connected", "accounts": ib.managedAccounts()}

• src/ib_async_mcp/server.py:67-79 (schema)

  Definition and schema of the 'connect' tool.

  Tool(
      name="connect",
      description="Connect to TWS or IB Gateway. Must be called before using other tools.",
      inputSchema={
          "type": "object",
          "properties": {
              "host": {"type": "string", "default": "127.0.0.1", "description": "TWS/Gateway host"},
              "port": {"type": "integer", "default": 7496, "description": "Port (7496 for TWS, 4001 for Gateway)"},
              "client_id": {"type": "integer", "default": 1, "description": "Client ID"},
              "readonly": {"type": "boolean", "default": True, "description": "Read-only mode"},
          },
      },
  ),